CAtlFileMappingBase::OpenMapping

调用此方法打开已指定文件的命名文件映射的对象。

HRESULT OpenMapping(
   LPCTSTR szName,
   SIZE_T nMappingSize,
   ULONGLONG nOffset = 0,
   DWORD dwViewDesiredAccess = FILE_MAP_ALL_ACCESS 
) throw( );

参数

  • szName
    映射对象的名称。 如果有一个打开句柄保持对一映射文件的对象由此名称,在映射对象的安全说明符不冲突与 dwViewDesiredAccess 参数,打开操作成功。

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

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

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

返回值

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

备注

如果输入参数无效,在调试版本中,断言会出现错误。

要求

Header: atlfile.h

请参见

参考

CAtlFileMappingBase选件类

CAtlFileMappingBase::MapFile