CAtlFileMappingBase::MapFile

Rufen Sie diese Methode auf, um ein Dateizuordnungsobjekt für die angegebene Datei zu öffnen oder zu erstellen.

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

Parameter

• hFile
  Handle zur Datei, aus der ein Zuordnungsobjekt erstellt werden soll.hFile muss gültig sein und kann nicht auf INVALID_HANDLE_VALUE festgelegt werden.

• nMappingSize
  Die Zuweisungsgröße.Wenn 0, die maximale Größe des Dateizuordnungsobjekts gleich die aktuelle Größe der Datei ist, die von hFile identifiziert wird.

• nOffset
  Die Datei glich aus, wobei das Zuordnen beginnen soll.Der Offsetwert muss ein Vielfaches der Speicherbelegungsgranularität des Systems sein.

• dwMappingProtection
  Der Schutz der gewünschten für die Dateiansicht, wenn die Datei zugeordnet ist.Siehe flProtect in CreateFileMapping in Windows SDK.

• dwViewDesiredAccess
  Gibt den Typ des Zugriffs auf die Dateiansicht und daher den Schutz der Seiten an, die von der Datei zugeordnet sind.Siehe dwDesiredAccess in MapViewOfFileEx in Windows SDK.

Rückgabewert

Gibt S_OK bei Erfolg oder einen Fehler HRESULT auf Fehler zurück.

Hinweise

Nachdem ein Dateizuordnungsobjekt erstellt wurde, darf die Größe der Datei die Größe des Dateizuordnungsobjekts nicht überschreiten, Wenn dies der Fall ist, ist der Inhalt nicht aller Datei zum Freigeben verfügbar.Weitere Informationen finden Sie unter CreateFileMapping und MapViewOfFileEx in Windows SDK.

Beispiel

Im Beispiel für CAtlFileMappingBase::CAtlFileMappingBase.

Anforderungen

Header: atlfile.h

Siehe auch

Referenz

CAtlFileMappingBase-Klasse