VirtualProtectEx 函式 (memoryapi.h)

發行項
03/05/2024

變更指定進程虛擬位址空間中已認可頁面區域的保護。

語法

BOOL VirtualProtectEx(
  [in]  HANDLE hProcess,
  [in]  LPVOID lpAddress,
  [in]  SIZE_T dwSize,
  [in]  DWORD  flNewProtect,
  [out] PDWORD lpflOldProtect
);

參數

[in] hProcess

要變更其記憶體保護的進程句柄。句柄必須具有 PROCESS_VM_OPERATION 訪問許可權。如需詳細資訊，請參閱處理安全性和訪問許可權。

[in] lpAddress

要變更其存取保護屬性的頁面區域基位址指標。

指定區域中的所有頁面都必須位於使用 MEM_RESERVE 呼叫 VirtualAlloc 或 VirtualAllocEx 函式時所配置的相同保留區域。頁面無法使用MEM_RESERVE個別呼叫 VirtualAlloc 或 VirtualAllocEx 所配置的相鄰保留區域。

[in] dwSize

存取保護屬性變更的區域大小，以位元組為單位。受影響的頁面區域包含範圍中包含一或多個字節的所有頁面，從 lpAddress 參數到 (lpAddress+dwSize)。這表示跨頁面界限的 2 位元組範圍會導致這兩個頁面的保護屬性變更。

[in] flNewProtect

記憶體保護選項。此參數可以是其中一個記憶體保護常數。

對於對應的檢視，此值必須與對應檢視時所指定的存取保護相容 (請參閱 MapViewOfFile、MapViewOfFileEx 和 MapViewOfFileExNuma) 。

[out] lpflOldProtect

變數的指標，可接收頁面指定區域中第一頁的先前存取保護。如果此參數為 NULL 或未指向有效的變數，則函式會失敗。

傳回值

如果函式成功，則傳回非零的值。

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

備註

存取保護值只能在已認可的頁面上設定。如果未認可指定區域中的任何頁面狀態，函式會失敗並傳回，而不會修改指定區域中任何頁面的存取保護。

PAGE_GUARD保護修飾詞會建立防護頁面。防護頁面可作為單次存取警示。如需詳細資訊，請參閱 Creating Guard Pages (建立防護頁面)。

最好避免使用 VirtualProtectEx 來變更 GlobalAlloc、 HeapAlloc 或 LocalAlloc 所配置記憶體區塊的頁面保護，因為多個記憶體區塊可以存在於單一頁面上。堆積管理員假設堆積中的所有頁面至少授與讀取和寫入許可權。

保護將可執行的區域時，呼叫程式會負責在程式代碼設定完成後，透過適當的 FlushInstructionCache 呼叫確保快取共通。否則，嘗試從新執行的區域執行程序代碼可能會產生無法預測的結果。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	memoryapi.h (包括 Windows.h、Memoryapi.h)
程式庫	onecore.lib
DLL	Kernel32.dll