通过

CAtlFileMappingBase::MapFile

  • 项目

调用此方法以打开或创建为指定的文件的文件映射对象。

HRESULT MapFile(
   HANDLE hFile,
   SIZE_T nMappingSize = 0,
   ULONGLONG nOffset = 0,
   DWORD dwMappingProtection = PAGE_READONLY,
   DWORD dwViewDesiredAccess = FILE_MAP_READ 
) throw( );

参数

  • hFile
    为创建一个映射的对象文件的处理。 hFile 必须是有效的，并且不能设置为INVALID_HANDLE_VALUE。

  • nMappingSize
    映射范围。 如果为 0，文件映射对象的最大大小与 *hFile.*确定文件的当前大小相等。

  • nOffset
    文件偏移量映射是开始的位置。 偏移量值必须是系统的内存分配粒度的多个。

  • dwMappingProtection
    文件在映射时，从而保护为文件视图即可。 在参见 CreateFileMapping 的 flProtect 在 Windows SDK。

  • dwViewDesiredAccess
    指定访问的类型设置为文件视图的，因此，因此，文件映射的页的保护。 在参见 MapViewOfFileEx 的 dwDesiredAccess 在 Windows SDK。

返回值

返回在成功的 S_OK 或在失败时的错误 HRESULT。

备注

在一个文件映射对象在创建后，文件大小不能超过文件映射对象的大小;如果它，并非所有文件的目录为共享将可用。 有关详细信息，请参见 CreateFileMapping 和 MapViewOfFileEx 在 Windows SDK。

示例

为 CAtlFileMappingBase::CAtlFileMappingBase参见示例。

要求

Header: atlfile.h

请参见

参考

CAtlFileMappingBase选件类