CAtlFileMappingBase::OpenMapping

  • [アーティクル]

更新 : 2007 年 11 月

指定したファイルに対する名前付きファイル マップ オブジェクトを開きます。

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

パラメータ

  • szName
    マップ オブジェクト名。この名前のファイル マップ オブジェクトへの開いているハンドルが存在し、マップ オブジェクトのセキュリティ記述子が dwViewDesiredAccess パラメータと矛盾しないときに、開く操作が成功します。

  • nMappingSize
    マップ サイズ。0 の場合、ファイル マップ オブジェクトの最大サイズは、szName. で指定されたファイル マップ オブジェクトの現在のサイズに一致します。

  • nOffset
    割り当てを開始するファイルのオフセット。オフセット値は、システムのメモリ割り当ての単位の倍数であることが必要です。

  • dwViewDesiredAccess
    ファイル ビューへのアクセスの種類。これを指定することによって、ファイルによって割り当てられたページの保護も指定されます。Windows SDK の「MapViewOfFileEx」で dwDesiredAccess に関する説明を参照してください。

戻り値

正常に終了した場合は、S_OK を返します。それ以外の場合は、エラーの HRESULT を返します。

解説

デバッグ ビルドでは、入力パラメータが無効な場合にアサーション エラーが発生します。

必要条件

ヘッダー : atlfile.h

参照

参照

CAtlFileMappingBase クラス

CAtlFileMappingBase::MapFile

その他の技術情報

CAtlFileMappingBase のメンバ