File and Path Function

FILE *_fsopen(const char *filename, const char *mode, int shflag);

FILE *_wfsopen(const wchar_t *filename, const wchar_t *mode, int shflag);

FILE *_tfsopen( const TCHAR *filename, const TCHAR *mode, int shflag);

Internationalization (I18n) Function Overview

The _fsopen function opens the file specified by filename as a stream and prepares the file for subsequent shared reading or writing, as defined by the mode and shflag arguments. If successful, the stream object is returned; otherwise NULL is returned to indicate an error.

_wsopen is the wide version of the function; its parameters are wide character strings.

_tfsopen is the Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _fsopen or _wfsopen.

See the MSDN Library for more information on the type of access permitted (mode) and the type of sharing allowed (shflag).

I18n Issues

Use the appropriate version of the function as required for internationalization support.

See Pathnames for a discussion of path and filename considerations in an internationalized application, and File I/O, which addresses reading and writing non-ASCII text data files.

Recommended Replacements*

Microsoft Windows MBCS	fsopen
Microsoft Windows Unicode	_wfsopen
Microsoft Windows Generic	_tfsopen

File and Path Functions