Freigeben über

CAtlFileMappingBase::OpenMapping

  • Artikel

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 Class

CAtlFileMappingBase::MapFile