Condividi tramite


CAtlFileMappingBase::OpenMapping

Chiamare questo metodo per aprire un oggetto denominato dei file per il file specificato.

HRESULT OpenMapping(
   LPCTSTR szName,
   SIZE_T nMappingSize,
   ULONGLONG nOffset = 0,
   DWORD dwViewDesiredAccess = FILE_MAP_ALL_ACCESS 
) throw( );

Parametri

  • szName
    Il nome dell'oggetto mapping.Se esiste un handle aperto a un oggetto mappa del file da questo nome e il descrittore di sicurezza sull'oggetto mapping non sia in conflitto con il parametro dwViewDesiredAccess, l'operazione di apertura riesce.

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

  • 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.

  • 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

Nelle build di debug, un errore di asserzione si verificherà se i parametri di input non sono validi.

Requisiti

Header: atlfile.h

Vedere anche

Riferimenti

Classe di CAtlFileMappingBase

CAtlFileMappingBase::MapFile