_get_osfhandle
Visual Studio .NET 2003
Returns operating-system file handle associated with existing low level file descriptor.
long _get_osfhandle( int fd );
Parameter
- fd
- User file descriptor.
Return Value
The _get_osfhandle function returns an OS file handle if fd (the low level file descriptor) is in range and if it is internally marked as free. Otherwise it returns INVALID_HANDLE_VALUE (–1) and sets errno to EBADF, indicating an invalid file handle.
Requirements
| Routine | Required header | Compatibility |
|---|---|---|
| _get_osfhandle | <io.h> | Win 98, Win Me, Win NT, Win 2000, Win XP |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
All versions of the C run-time libraries.
See Also
File Handling Routines | _close | _creat | _dup | _open | Run-Time Routines and .NET Framework Equivalents
