The OpenFileMapping function opens a named file-mapping object.
HANDLE OpenFileMapping(
DWORD dwDesiredAccess, // access mode
BOOL bInheritHandle, // inherit flag
LPCTSTR lpName // pointer to name of file-mapping object
);
Windows NT: This access is checked against any security descriptor on the target file-mapping object.
Windows 95 and Windows 98: Security descriptors on file mapping objects are not supported.
This parameter can be one of the following values:
Value | Meaning |
---|---|
FILE_MAP_WRITE | Read-write access. The target file-mapping object must have been created with PAGE_READWRITE protection. A read-write view of the file is mapped. |
FILE_MAP_READ | Read-only access. The target file-mapping object must have been created with PAGE_READWRITE or PAGE_READ protection. A read-only view of the file is mapped. |
FILE_MAP_ALL_ACCESS | Same as FILE_MAP_WRITE. |
FILE_MAP_COPY | Copy-on-write access. The target file-mapping object must have been created with PAGE_WRITECOPY protection. A copy-on-write view of the file is mapped. |
If the function succeeds, the return value is an open handle to the specified file-mapping object.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
The handle that OpenFileMapping returns can be used with any function that requires a handle to a file-mapping object.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in winbase.h.
Import Library: Use kernel32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
File Mapping Overview, File Mapping Functions, CreateFileMapping