CAtlFileMappingBase::MapFile
Wywołanie tej metody Otwórz lub Utwórz obiekt mapowania pliku dla określonego pliku.
HRESULT MapFile(
HANDLE hFile,
SIZE_T nMappingSize = 0,
ULONGLONG nOffset = 0,
DWORD dwMappingProtection = PAGE_READONLY,
DWORD dwViewDesiredAccess = FILE_MAP_READ
) throw( );
Parametry
hFile
Dojście do pliku, z których można utworzyć obiektu mapowania.hFilemusi być prawidłowy i nie można ustawić INVALID_HANDLE_VALUE.nMappingSize
Rozmiar mapowania.Jeśli 0, maksymalny rozmiar obiektu mapowania pliku jest równa się bieżący rozmiar pliku, identyfikowane przez hFile.nOffset
Przesunięcie pliku, gdzie ma rozpocząć mapowanie.Wartość przesunięcia musi być wielokrotnością ziarnistość alokacji pamięci systemowej.dwMappingProtection
Ochrony pożądane dla widoku pliku, gdy plik jest zamapowany.Zobacz flProtect w CreateFileMapping w Windows SDK.dwViewDesiredAccess
Określa typ dostępu do widoku pliku, a zatem ochrony strony mapowane przez plik.Zobacz dwDesiredAccess w MapViewOfFileEx w Windows SDK.
Wartość zwracana
Zwraca S_OK o powodzeniu lub błędzie HRESULT w przypadku awarii.
Uwagi
Po utworzeniu obiektu mapowania pliku, rozmiar pliku nie może przekraczać rozmiaru obiektu mapowania pliku; Jeśli tak, nie wszystkie jego zawartość będzie dostępne dla udostępniania.Aby uzyskać więcej informacji, zobacz CreateFileMapping i MapViewOfFileEx w Windows SDK.
Przykład
Zobacz przykład dla CAtlFileMappingBase::CAtlFileMappingBase.
Wymagania
Nagłówek: atlfile.h