MapViewOfFileFromApp 函式（memoryapi.h）

發行項
11/12/2024

將檔案對應的檢視對應至呼叫 Windows 市集應用程式的地址空間。

語法

PVOID MapViewOfFileFromApp(
  [in] HANDLE  hFileMappingObject,
  [in] ULONG   DesiredAccess,
  [in] ULONG64 FileOffset,
  [in] SIZE_T  NumberOfBytesToMap
);

參數

[in] hFileMappingObject

檔案對應物件的句柄。 CreateFileMappingFromApp 函式會傳回此句柄。

[in] DesiredAccess

檔案對應物件的存取類型，決定頁面的頁面保護。此參數可以是下列其中一個值，或適當時為多個值的位 OR 組合。

價值	意義
FILE_MAP_ALL_ACCESS	檔案的讀取/寫入檢視已對應。檔案對應對象必須使用 PAGE_READWRITE 保護來建立。與 mapViewOfFileFromApp搭配使用時，FILE_MAP_ALL_ACCESS 相當於 FILE_MAP_WRITE。
FILE_MAP_READ	檔案的只讀檢視已對應。嘗試寫入檔案檢視會導致存取違規。檔案對應對象必須使用 PAGE_READONLY、PAGE_READWRITE、PAGE_EXECUTE_READ或 PAGE_EXECUTE_READWRITE 保護來建立。
FILE_MAP_WRITE	檔案的讀取/寫入檢視已對應。檔案對應對象必須使用 PAGE_READWRITE 保護來建立。與 mapViewOfFileFromApp搭配使用時，`(FILE_MAP_WRITE \| FILE_MAP_READ)` 相當於 FILE_MAP_WRITE。

使用位 OR，您可以將上述值與這些值結合。

價值	意義
FILE_MAP_COPY	檔案的複製寫入檢視已對應。檔案對應對象必須使用 PAGE_READONLY、PAGE_EXECUTE_READ、PAGE_WRITECOPY或 PAGE_READWRITE 保護來建立。當行程寫入寫入至寫入複本頁面時，系統會將原始頁面複製到程式私用的新頁面。新頁面是由分頁檔案所支援。新頁面的保護會從複製寫入變更為讀取/寫入。指定寫入時複製存取權時，系統與進程認可會針對整個檢視負責，因為呼叫程式可能會寫入檢視中的每個頁面，使所有頁面都成為私人。新頁面的內容永遠不會寫回源檔，而且會在取消對應檢視時遺失。
FILE_MAP_LARGE_PAGES	從 Windows 10 版本 1703 開始，此旗標會指定應該使用大型頁面支援對應檢視。檢視的大小必須是 GetLargePageMinimum 函式所報告之大型頁面大小的倍數，而且必須使用 SEC_LARGE_PAGES 選項建立檔案對應物件。如果您為 lpBaseAddress提供非 Null 值，則此值必須是 getLargePageMinimum 的倍數。
FILE_MAP_TARGETS_INVALID	將對應檔案中的所有位置設定為控制流程防護（CFG）無效的目標。此旗標類似於 PAGE_TARGETS_INVALID。將此旗標與執行存取權限搭配使用，FILE_MAP_EXECUTE。對這些頁面中位置的任何間接呼叫都會失敗 CFG 檢查，且程式將會終止。配置之可執行頁面的預設行為是標示 CFG 的有效呼叫目標。

價值

意義

FILE_MAP_COPY

檔案的複製寫入檢視已對應。檔案對應對象必須使用 PAGE_READONLY、PAGE_EXECUTE_READ、PAGE_WRITECOPY或 PAGE_READWRITE 保護來建立。

當行程寫入寫入至寫入複本頁面時，系統會將原始頁面複製到程式私用的新頁面。新頁面是由分頁檔案所支援。新頁面的保護會從複製寫入變更為讀取/寫入。

指定寫入時複製存取權時，系統與進程認可會針對整個檢視負責，因為呼叫程式可能會寫入檢視中的每個頁面，使所有頁面都成為私人。新頁面的內容永遠不會寫回源檔，而且會在取消對應檢視時遺失。

FILE_MAP_LARGE_PAGES

從 Windows 10 版本 1703 開始，此旗標會指定應該使用大型頁面支援對應檢視。檢視的大小必須是 GetLargePageMinimum 函式所報告之大型頁面大小的倍數，而且必須使用 SEC_LARGE_PAGES 選項建立檔案對應物件。如果您為 lpBaseAddress提供非 Null 值，則此值必須是 getLargePageMinimum 的倍數。

FILE_MAP_TARGETS_INVALID

將對應檔案中的所有位置設定為控制流程防護（CFG）無效的目標。此旗標類似於 PAGE_TARGETS_INVALID。將此旗標與執行存取權限搭配使用，FILE_MAP_EXECUTE。對這些頁面中位置的任何間接呼叫都會失敗 CFG 檢查，且程式將會終止。配置之可執行頁面的預設行為是標示 CFG 的有效呼叫目標。

對於使用 SEC_IMAGE 屬性建立的檔案對應物件，dwDesiredAccess 參數沒有任何作用，而且應該設定為任何有效的值，例如 FILE_MAP_READ。

如需檔案對應物件存取權的詳細資訊，請參閱檔案對應安全性和存取權限。

[in] FileOffset

檢視開始位置的檔案位移。位移必須指定檔案對應內的位移。它們也必須符合系統的記憶體配置粒度。也就是說，位移必須是配置粒度的倍數。若要取得系統的記憶體配置粒度，請使用 GetSystemInfo 函式，以填入 SYSTEM_INFO 結構的成員。

[in] NumberOfBytesToMap

對應至檢視之檔案對應的位元組數目。所有位元組必須位於 createFileMappingFromApp 所指定的大小上限內，。如果此參數為 0 （零），則對應會從指定的位移延伸至檔案對應的結尾。

傳回值

如果函式成功，傳回值就是對應檢視的起始位址。

如果函式失敗，則傳回值 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

有一個重要的例外狀況，衍生自相同檔案所支援之任何檔案對應對象的檔案檢視在特定時間是一致或完全相同的。針對進程內的檢視，以及由不同進程對應的檢視，保證一致性。

例外狀況與遠端檔案相關。雖然 MapViewOfFileFromApp 與遠端檔案搭配運作，但它不會保持一致。例如，如果兩部計算機將檔案對應為可寫入，而且兩者都變更了相同的頁面，則每部計算機只會看到自己的寫入頁面。當數據在磁碟上更新時，它不會合併。

如果您的應用程式具有 codeGeneration 功能，您才能成功要求可執行文件保護。

要求

要求	價值
最低支援的用戶端	Windows 8 [傳統型應用程式 \|UWP 應用程式]
支援的最低伺服器	Windows Server 2012 [傳統型應用程式 \|UWP 應用程式]
目標平臺	窗戶
標頭	memoryapi.h （包括 Windows.h）
連結庫	onecore.lib
DLL	Kernel32.dll