Associates a C run-time file handle with a existing operating-system file handle.
int _open_osfhandle ( long osfhandle, int flags );
| Routine | Required Header | Compatibility |
| _open_osfhandle | <io.h> | Win 95, Win NT |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
| LIBC.LIB | Single thread static library, retail version |
| LIBCMT.LIB | Multithread static library, retail version |
| MSVCRT.LIB | Import library for MSVCRT.DLL, retail version |
Return Value
If successful, _open_osfhandle returns a C run-time file handle. Otherwise, it returns –1.
Parameters
osfhandle
Operating-system file handle
flags
Types of operations allowed
Remarks
The _open_osfhandle function allocates a C run-time file handle and sets it to point to the operating-system file handle specified by osfhandle. The flags argument is an integer expression formed from one or more of the manifest constants defined in FCNTL.H. When two or more manifest constants are used to form the flags argument, the constants are combined with the bitwise-OR operator ( | ).
The FCNTL.H file defines the following manifest constants:
_O_APPEND
Positions file pointer to end of file before every write operation.
_O_RDONLY
Opens file for reading only
_O_TEXT
Opens file in text (translated) mode