VirtualProtectFromApp 函式 (memoryapi.h)

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

語法

BOOL VirtualProtectFromApp(
  [in]  PVOID  Address,
  [in]  SIZE_T Size,
  [in]  ULONG  NewProtection,
  [out] PULONG OldProtection
);

參數

[in] Address

指標，描述要變更其存取保護屬性之頁面區域的起始頁面。

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

[in] Size

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

[in] NewProtection

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

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

下列常數會產生錯誤：

• PAGE_EXECUTE_READWRITE
• PAGE_EXECUTE_WRITECOPY

只有具有 codeGeneration 功能的應用程式才允許下列常數：

• PAGE_EXECUTE
• PAGE_EXECUTE_READ

[out] OldProtection

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

傳回值

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

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

備註

您可以從具有 Just-In-Time (JIT) 功能的 Windows 市集應用程式呼叫 VirtualProtectFromApp ，以使用 JIT 功能。 應用程式必須在應用程式指令清單檔案中包含 codeGeneration 功能，才能使用 JIT 功能。

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

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

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

VirtualProtectFromApp 可讓您將頁面標示為可執行檔，但不允許同時設定寫入和執行許可權。

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

規格需求

需求	值
最低支援的用戶端	Windows 10 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2016 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	memoryapi.h (包含 Windows.h)
程式庫	WindowsApp.lib
DLL	Kernel32.dll

另請參閱

記憶體管理功能

虛擬記憶體函式

VirtualAllocFromApp

VirtualProtect

VirtualProtectEx