Platform SDK: Files and I/O |
The _lopen function opens an existing file and sets the file pointer to the beginning of the file.
Note This function is provided only 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.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in Winbase.h; include Windows.h.
Library: Use Kernel32.lib.