CAtlFileMappingBase::MapFile

Článek
06/09/2015

Volání této metody otevřít nebo vytvořit mapování souboru objektu zadaného souboru.

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

Parametry

hFile
Popisovač souboru, ze kterého chcete vytvořit objekt mapování.hFilemusí být platný a nesmí být nastavena na INVALID_HANDLE_VALUE.
nMappingSize
Velikost mapování.Pokud je 0, maximální velikost objektu mapování souboru je rovna aktuální velikost souboru označeny hFile.
nOffset
Posun souboru, kde má začít mapování.Hodnotu posunu musí být násobkem granularity přidělení paměti v systému.
dwMappingProtection
Ochrana požadované pro zobrazení souboru, když je mapována na soubor.Viz flProtect v CreateFileMapping v .
dwViewDesiredAccess
Určuje typ přístupu k zobrazení souboru a tedy ochrana stránky mapovat soubor.Viz dwDesiredAccess v MapViewOfFileEx v .

Vrácená hodnota

Vrátí S_OK na úspěchu nebo chybu HRESULT při selhání.

Poznámky

Po vytvoření objektu mapování souboru, velikost souboru nesmí přesáhnout velikost objektu mapování souboru; Pokud ano, všechny jeho obsah bude k dispozici pro sdílení.Další podrobnosti viz CreateFileMapping a MapViewOfFileEx v .

Příklad

Příklad pro CAtlFileMappingBase::CAtlFileMappingBase.

Požadavky

Záhlaví: atlfile.h

Viz také

Referenční dokumentace

Třída CAtlFileMappingBase

Sdílet prostřednictvím