CAtlFileMappingBase::MapFile
Appelez cette méthode pour ouvrir ou créer un objet de mappage de fichier du fichier spécifié.
HRESULT MapFile(
HANDLE hFile,
SIZE_T nMappingSize = 0,
ULONGLONG nOffset = 0,
DWORD dwMappingProtection = PAGE_READONLY,
DWORD dwViewDesiredAccess = FILE_MAP_READ
) throw( );
Paramètres
hFile
Handle vers le fichier à partir duquel pour créer un objet de mappage. hFile doit être valide et ne peut pas être défini à INVALID_HANDLE_VALUE.nMappingSize
La taille de mappage. Si 0, la taille maximale de l'objet de mappage de fichier est égale à la taille actuelle du fichier identifié par hFile.nOffset
Le fichier est décalé où le mappage est de commencer. La valeur de décalage doit être un multiple de la granularité de l'allocation de mémoire du système.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
Une fois un objet de mappage de fichier créé, la taille du fichier ne doit pas dépasser la taille de l'objet de mappage de fichier ; si tel est le cas, le contenu de la totalité des fichiers est disponible pour le partage. Pour plus d'informations, consultez CreateFileMapping et le MapViewOfFileEx dans Kit de développement logiciel Windows.
Exemple
Consultez l'exemple pour CAtlFileMappingBase::CAtlFileMappingBase.
Configuration requise
Header: atlfile.h