CAtlFileMappingBase::OpenMapping

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

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

Parameter

• szName
  Der Name des Zuordnungsobjekts.Wenn es ein geöffnetes Handle zu einem Dateizuordnungsobjekt mit diesem Namen gibt und die Sicherheitsbeschreibung auf dem Zuordnungsobjekt nicht mit dem dwViewDesiredAccess-Parameter verursacht, folgt der Öffnungsvorgang.

• nMappingSize
  Die Zuweisungsgröße.Wenn 0, die maximale Größe des Dateizuordnungsobjekts gleich der aktuellen Größe des Dateizuordnungsobjekts ist, das von szName. identifiziert wird

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

• 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

In Debugbuilds ein Assertionsfehler tritt auf, wenn die Eingabeparameter ungültig sind.

Anforderungen

Header: atlfile.h

Siehe auch

Referenz

CAtlFileMappingBase-Klasse

CAtlFileMappingBase::MapFile