次の方法で共有

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
    ファイル割り当て時にファイルのビューに必要な保護。Windows SDK の「CreateFileMapping」で flProtect に関する説明を参照してください。

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

戻り値

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

解説

ファイル マップ オブジェクトを作成した後は、ファイル サイズがファイル マップ オブジェクトのサイズを超えることはできません。ファイル サイズがファイル マップ オブジェクトのサイズを超えた場合、一部のファイルの内容を共有できなくなる可能性があります。詳細については、Windows SDK の「CreateFileMapping」および「MapViewOfFileEx」を参照してください。

使用例

「CAtlFileMappingBase::CAtlFileMappingBase」の例を参照してください。

必要条件

ヘッダー : atlfile.h

参照

関連項目

CAtlFileMappingBase クラス