GetProcessMitigationPolicy 函式 (processthreadsapi.h)

發行項
03/08/2023

擷取呼叫進程的風險降低原則設定。

語法

BOOL GetProcessMitigationPolicy(
  [in]  HANDLE                    hProcess,
  [in]  PROCESS_MITIGATION_POLICY MitigationPolicy,
  [out] PVOID                     lpBuffer,
  [in]  SIZE_T                    dwLength
);

參數

[in] hProcess

進程的控制碼。此控制碼必須具有PROCESS_QUERY_INFORMATION存取權限。如需詳細資訊，請參閱處理安全性和存取權限。

[in] MitigationPolicy

要擷取的風險降低原則。此參數可以是下列其中一個值。

值	意義
ProcessDEPPolicy	程式的資料執行防止 (DEP) 原則。 lpBuffer參數指向指定 DEP 原則旗標的PROCESS_MITIGATION_DEP_POLICY結構。
ProcessASLRPolicy	進程的位址空間配置隨機化 (ASLR) 原則。 lpBuffer參數指向指定 ASLR 原則旗標的PROCESS_MITIGATION_ASLR_POLICY結構。
ProcessDynamicCodePolicy	進程的動態程式碼原則。開啟時，進程無法產生動態程式碼或修改現有的可執行程式碼。 lpBuffer參數指向指定動態程式碼原則旗標的PROCESS_MITIGATION_DYNAMIC_CODE_POLICY結構。
ProcessStrictHandleCheckPolicy	如果進程操作不正確控制碼，進程將會收到嚴重錯誤。 lpBuffer參數指向指定控制碼檢查原則旗標的PROCESS_MITIGATION_STRICT_HANDLE_CHECK_POLICY結構。
ProcessSystemCallDisablePolicy	停用在最低層使用 NTUser/GDI 函式的能力。 lpBuffer參數指向指定系統呼叫停用原則旗標的PROCESS_MITIGATION_SYSTEM_CALL_DISABLE_POLICY結構。
ProcessMitigationOptionsMask	針對系統上的所有風險降低選項，傳回有效位的遮罩。應用程式可以設定許多風險降低選項，而不需查詢作業系統以取得風險降低選項，方法是將位與遮罩結合在一起，以同時排除所有不支援的位。 lpBuffer參數指向遮罩的ULONG64位向量，或ULONG64位向量的雙元素陣列。
ProcessExtensionPointDisablePolicy	防止啟用某些內建協力廠商擴充點，防止舊版擴充點 DLL 載入進程。 lpBuffer參數指向指定擴充點停用原則旗標的PROCESS_MITIGATION_EXTENSION_POINT_DISABLE_POLICY結構。
ProcessControlFlowGuardPolicy	控制流程防護 (CFG) 程式的原則。 lpBuffer參數指向指定 CFG 原則旗標的PROCESS_MITIGATION_CONTROL_FLOW_GUARD_POLICY結構。
ProcessSignaturePolicy	可將影像載入限制為 Microsoft、Windows 市集或 Microsoft、Windows 市集和 Windows 硬體品質實驗室 (WHQL) 所簽署映射的程式原則。 he lpBuffer 參數指向指定簽章原則旗標的PROCESS_MITIGATION_BINARY_SIGNATURE_POLICY 結構。
ProcessFontDisablePolicy	程式字型載入的相關原則。開啟時，進程無法載入非系統字型。 lpBuffer參數指向指定字型載入原則旗標的 PROCESS_MITIGATION_FONT_DISABLE_POLICY結構。
ProcessImageLoadPolicy	進程影像載入的相關原則，決定允許對應至進程的可執行映射類型。開啟時，無法從某些位置載入影像，例如具有低強制標籤的遠端裝置或檔案。 lpBuffer參數指向指定影像載入原則旗標的PROCESS_MITIGATION_IMAGE_LOAD_POLICY結構。
ProcessRedirectionTrustPolicy	進程的 RedirectionGuard 原則。 lpBuffer參數會指向指定風險降低模式的PROCESS_MITIGATION_REDIRECTION_TRUST_POLICY結構。
ProcessSideChannelIsolationPolicy	Windows 10 版本 1809和更新版本：與指定進程之側邊通道隔離相關的原則。 lpBuffer參數會指向PROCESS_MITIGATION_SIDE_CHANNEL_ISOLATION_POLICY結構，指定側邊通道隔離的原則旗標。
ProcessUserShadowStackPolicy	Windows 10版本 2004 和更新版本：針對指定的程式，關於使用者模式硬體強制堆疊保護的原則。 lpBuffer參數指向PROCESS_MITIGATION_USER_SHADOW_STACK_POLICY結構，指定使用者模式硬體強制堆疊保護的原則旗標。

[out] lpBuffer

如果 MitigationPolicy 參數為 ProcessDEPPolicy，此參數會指向接收 DEP 原則旗標的PROCESS_MITIGATION_DEP_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessASLRPolicy，此參數會指向接收 ASLR 原則旗標的PROCESS_MITIGATION_ASLR_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessDynamicCodePolicy，此參數會指向接收動態程式碼原則旗標的PROCESS_MITIGATION_DYNAMIC_CODE_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessStrictHandleCheckPolicy，此參數會指向指定控制碼檢查原則旗標的PROCESS_MITIGATION_STRICT_HANDLE_CHECK_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessSystemCallDisablePolicy，此參數會指向指定系統呼叫停用原則旗標的PROCESS_MITIGATION_SYSTEM_CALL_DISABLE_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessMitigationOptionsMask，此參數會指向遮罩 的ULONG64 位向量，或 ULONG64 位向量的兩個專案陣列。

如果 MitigationPolicy 參數是 ProcessExtensionPointDisablePolicy，此參數會指向指定擴充點停用原則旗標的PROCESS_MITIGATION_EXTENSION_POINT_DISABLE_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessControlFlowGuardPolicy，此參數會指向指定 CFG 原則旗標的PROCESS_MITIGATION_CONTROL_FLOW_GUARD_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessSignaturePolicy，此參數會指向接收簽章原則旗標的PROCESS_MITIGATION_BINARY_SIGNATURE_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessFontDisablePolicy，此參數會指向接收字型載入原則旗標的PROCESS_MITIGATION_FONT_DISABLE_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessImageLoadPolicy，此參數會指向接收影像載入原則旗標的PROCESS_MITIGATION_IMAGE_LOAD_POLICY 結構。

如果 MitigationPolicy 參數是 ProcessRedirectionTrustPolicy，此參數會指向指定風險降低模式的PROCESS_MITIGATION_REDIRECTION_TRUST_POLICY結構。

如果 MitigationPolicy 參數是 ProcessUserShadowStackPolicy，此參數會指向 PROCESS_MITIGATION_USER_SHADOW_STACK_POLICY 結構，該結構會接收使用者模式硬體強制堆疊保護的原則旗標。

[in] dwLength

lpBuffer的大小，以位元組為單位。

傳回值

如果函式成功，則會傳回 TRUE。如果函式失敗，則會傳回 FALSE。若要擷取為此函式定義的錯誤值，請呼叫 GetLastError。

備註

若要編譯使用此函式的應用程式，請設定 _WIN32_WINNT > = 0x0602。如需詳細資訊，請參閱使用 Windows 標頭。

需求


最低支援的用戶端	Windows 8 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	processthreadsapi.h
程式庫	Kernel32.lib
DLL	Kernel32.dll

共用方式為

GetProcessMitigationPolicy 函式 (processthreadsapi.h)

語法

參數

傳回值

備註

需求

意見反應

其他資源