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 類別