The _lopen function opens an existing file and sets the file pointer to the beginning of the file. This function is provided for compatibility with 16-bit versions of Windows. Win32-based applications should use the CreateFile function.
HFILE _lopen(
| LPCSTR lpPathName, | // pointer to name of file to open |
| int iReadWrite | // file access mode |
| ); |
Parameters
lpPathName
Pointer to a null-terminated string that names the file to open. The string must consist of characters from the Windows ANSI character set.
iReadWrite
Specifies the modes in which to open the file. This parameter consists of one access mode and an optional share mode. The access mode must be one of the following values:
| Value | Meaning |
| OF_READ | Opens the file for reading only. |
| OF_READWRITE | Opens the file for reading and writing. |
| OF_WRITE | Opens the file for writing only. |
The share mode can be one of the following values:
| Value | Meaning |
| OF_SHARE_COMPAT | Opens the file in compatibility mode, enabling any process on a given computer to open the file any number of times. If the file has been opened by using any of the other share modes, _lopen fails. |
| OF_SHARE_DENY_NONE | Opens the file without denying other processes read or write access to the file. If the file has been opened in compatibility mode by any other process, _lopen fails. |
| OF_SHARE_DENY_READ | Opens the file and denies other processes read access to the file. If the file has been opened in compatibility mode or for read access by any other process, _lopen fails. |
| OF_SHARE_DENY_WRITE | Opens the file and denies other processes write access to the file. If the file has been opened in compatibility mode or for write access by any other process, _lopen fails. |
| OF_SHARE_EXCLUSIVE | Opens the file in exclusive mode, denying other processes both read and write access to the file. If the file has been opened in any other mode for read or write access, even by the current process, _lopen fails. |
Return Values
If the function succeeds, the return value is a file handle.
If the function fails, the return value is HFILE_ERROR. To get extended error information, call GetLastError.
See Also