Partager via


CAtlFileMappingBase::MapSharedMem

Appelez cette méthode pour créer un objet de mappage de fichier qui permet l'accès complet à tous les processus.

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( );

Paramètres

  • nMappingSize
    La taille de mappage. Si 0, la taille maximale de l'objet de mappage de fichier est égale à la taille actuelle de l'objet de mappage de fichier identifié par szName.

  • szName
    Le nom de l'objet de mappage.

  • pbAlreadyExisted
    Les points à un BOOL valeur qui est défini la valeur TRUE si l'objet de mappage existait déjà.

  • lpsa
    Le pointeur vers une structure de SECURITY_ATTRIBUTES qui détermine si le handle retourné peut être héritée par les processus enfant. Consultez les lpAttributes dans CreateFileMapping dans Kit de développement logiciel Windows.

  • dwMappingProtection
    La protection a souhaité pour l'affichage de fichier, lorsque le fichier est mappé. Consultez l' flProtect dans CreateFileMapping dans Kit de développement logiciel Windows.

  • dwViewDesiredAccess
    Spécifie le type de l'accès à l'affichage de fichier et, par conséquent, la protection des pages mappées par le fichier. Consultez l' dwDesiredAccess dans MapViewOfFileEx dans Kit de développement logiciel Windows.

Valeur de retour

Retourne S_OK en cas de réussite, ou une erreur HRESULT en cas de échec.

Notes

MapShareMem permet un objet de mappage de fichier existant, créé par CreateFileMapping, pour être partagé entre plusieurs processus.

Configuration requise

Header: atlfile.h

Voir aussi

Référence

CAtlFileMappingBase, classe