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 |
|
); |
|
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. |
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: