CAtlFileMappingBase::MapFile

Статья
06/09/2015

Вызовите этот метод, чтобы открыть или создать объект сопоставления файлов для указанного файла.

HRESULT MapFile( 
   HANDLE hFile, 
   SIZE_T nMappingSize = 0, 
   ULONGLONG nOffset = 0, 
   DWORD dwMappingProtection = PAGE_READONLY, 
   DWORD dwViewDesiredAccess = FILE_MAP_READ  
) throw( );

Параметры

hFile
Дескриптор к файлу, из которого создается сопоставление объект. hFile должно быть допустимым и не может быть установлено значение INVALID_HANDLE_VALUE.
nMappingSize
Размер сопоставления. Если значение равно 0, максимальный размер объекта сопоставления файлов текущему размера файла, указанного hFile.
nOffset
Смещение файла, в котором сопоставление разработки. Значение смещения должно быть кратным гранулярности выделения памяти системы.
dwMappingProtection
Защита пожелала для представления файла, если файл будет сопоставлен. См. раздел flProtect в CreateFileMapping в Windows SDK.
dwViewDesiredAccess
Определяет тип доступа к представлению файла защиту страниц и, следовательно, сопоставленных файлом. См. раздел dwDesiredAccess в MapViewOfFileEx в Windows SDK.

Возвращаемое значение

Возвращает S_OK в случае успеха или ошибки HRESULT при сбое.

Заметки

После того как объект сопоставления файлов был создания, размер файла не должен превышать размер объекта сопоставления файлов; если это так, то содержимое не всего файла будут доступны для совместного использования. Дополнительные сведения см. в разделе CreateFileMapping и MapViewOfFileEx в Windows SDK.

Пример

См. пример для CAtlFileMappingBase::CAtlFileMappingBase.

Требования

Header: atlfile.h

См. также

Ссылки

CAtlFileMappingBase Class

Поделиться через