Freigeben über


CAtlFileMappingBase::MapSharedMem

Rufen Sie diese Methode auf, um ein Dateizuordnungsobjekt zu erstellen, das allen Prozessen zulässt.

HRESULT MapSharedMem( 
   SIZE_T nMappingSize, 
   LPCTSTR szName, 
   BOOL* pbAlreadyExisted = NULL, 
   LPSECURITY_ATTRIBUTES lpsa = NULL, 
   DWORD dwMappingProtection = PAGE_READWRITE, 
   DWORD dwViewDesiredAccess = FILE_MAP_ALL_ACCESS  
) throw( );

Parameter

  • 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

  • szName
    Der Name des Zuordnungsobjekts.

  • pbAlreadyExisted
    Zeigt auf einen booleschen Wert, der festgelegt wird, um TRUE, wenn das Zuordnungsobjekt bereits vorhanden sind.

  • lpsa
    Der Zeiger auf eine Struktur SECURITY_ATTRIBUTES, die bestimmt, ob das zurückgegebene Handle durch untergeordnete Prozesse geerbt werden kann. Siehe lpAttributes in CreateFileMapping in Windows SDK.

  • 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

MapShareMem ermöglicht ein vorhandenes Dateizuordnungsobjekt erstellt, durch CreateFileMapping, zwischen Prozesse verwendet werden.

Anforderungen

Header: atlfile.h

Siehe auch

Referenz

CAtlFileMappingBase Class