VirtualProtect 函式 (memoryapi.h)
變更呼叫進程虛擬位址空間中已認可頁面區域的保護。
若要變更任何進程的存取保護,請使用 VirtualProtectEx 函 式。
語法
BOOL VirtualProtect(
[in] LPVOID lpAddress,
[in] SIZE_T dwSize,
[in] DWORD flNewProtect,
[out] PDWORD lpflOldProtect
);
參數
[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 (建立防護頁面)。
最好避免使用 VirtualProtect 來變更 GlobalAlloc、 HeapAlloc 或 LocalAlloc 所設定之內存區塊上的頁面保護,因為多個記憶體區塊可以存在於單一頁面上。 堆積管理員假設堆積中的所有頁面至少都會授與讀取和寫入許可權。
保護將可執行的區域時,呼叫程式會負責在程式代碼設定完成之後,透過適當的 FlushInstructionCache 呼叫來確保快取一致性。 否則,嘗試從新可執行區域執行程序代碼可能會產生無法預期的結果。
規格需求
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | memoryapi.h (包括 Windows.h、Memoryapi.h) |
程式庫 | onecore.lib |
DLL | Kernel32.dll |