CAtlFileMappingBase::MapFile

Chiamare questo metodo per aprire o creare un oggetto mappa del file per il file specificato.

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

Parametri

• hFile
  Handle del file da cui creare un oggetto mapping.hFile deve essere valido e non può essere impostato su INVALID_HANDLE_VALUE.

• nMappingSize
  La dimensione di rilevamento.Se 0, la dimensione massima dell'oggetto mappa del file è uguale a quella corrente del file identificato da hFile.

• nOffset
  Il file è sottoposto a offset in cui eseguire il mapping verrà avviato.Il valore di offset deve essere un multiplo di granularitàallocazione di memoria di sistema.

• dwMappingProtection
  La protezione ha previsto per la visualizzazione del file quando il file mappato.Vedere flProtect in CreateFileMapping in Windows SDK.

• dwViewDesiredAccess
  Specifica il tipo di accesso alla visualizzazione del file e, pertanto, la protezione delle pagine si esegue il mapping dal file.Vedere dwDesiredAccess in MapViewOfFileEx in Windows SDK.

Valore restituito

Restituisce S_OK su positivo, o un errore HRESULT in errore.

Note

Dopo che un oggetto mappa del file è stato creato, la dimensione del file non deve superare la dimensione dell'oggetto dei file; in caso affermativo, il contenuto di un file non saranno disponibili per condividere.Per ulteriori informazioni, vedere CreateFileMapping e MapViewOfFileEx in Windows SDK.

Esempio

Vedere l'esempio relativo CAtlFileMappingBase::CAtlFileMappingBase.

Requisiti

Header: atlfile.h

Vedere anche

Riferimenti

Classe di CAtlFileMappingBase