Share via

SaferGetPolicyInformation 函式 (winsafer.h)

  • 發行項

SaferGetPolicyInformation 函式會取得原則的相關資訊。 您可以查詢以找出原則的詳細資訊。

語法

BOOL SaferGetPolicyInformation(
  [in]  DWORD                   dwScopeId,
  [in]  SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in]  DWORD                   InfoBufferSize,
  [out] PVOID                   InfoBuffer,
  [out] PDWORD                  InfoBufferRetSize,
        LPVOID                  lpReserved
);

參數

[in] dwScopeId

查詢的範圍。 下表顯示可能的值。

值 意義
SAFER_SCOPEID_MACHINE
1
 查詢的範圍是電腦。
SAFER_SCOPEID_USER
2
 查詢的範圍是由使用者所依據。

[in] SaferPolicyInfoClass

SAFER_POLICY_INFO_CLASS列舉值，指定應該傳回的原則資訊類型。 指定的值會決定 InfoBuffer 參數的大小和類型。 下表顯示可能的值。

值 意義
SaferPolicyLevelList
1
 查詢原則中定義之所有層級的清單。

InfoBuffer 傳回類型：LevelIds 的 DWORD 陣列。
SaferPolicyEnableTransparentEnforcement
2
 查詢原則值，以判斷是否啟用 DLL 檢查。

InfoBuffer 傳回類型： DWORD 布林值。
SaferPolicyDefaultLevel
3
 預設原則層級的查詢。

InfoBuffer 傳回類型： DWORD LevelId。
SaferPolicyEvaluateUserScope
4
 查詢，以判斷是否應在原則評估期間參考使用者範圍規則。

InfoBuffer 傳回類型： DWORD。
SaferPolicyScopeFlags
5
 查詢，以判斷原則是否要略過本機系統管理員群組的成員。

InfoBuffer 傳回類型： DWORD。

[in] InfoBufferSize

InfoBuffer參數的大小，以位元組為單位。

[out] InfoBuffer

要包含查詢結果的緩衝區。 傳回信息的大小和類型是由 SaferPolicyInfoClass 參數所決定。 如需 SaferPolicyInfoClass 參數每個可能值的傳回信息類型，請參閱 SaferPolicyInfoClass 參數。

[out] InfoBufferRetSize

InfoBuffer參數中已填入原則資訊的位元組數目。

lpReserved

保留供未來使用。 此參數應該設定為 Null。

傳回值

如果函式成功，則為TRUE;否則為FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winsafer.h
程式庫 Advapi32.lib
Dll Advapi32.dll
API 集合 ext-ms-win-advapi32-safer-l1-1-0 (在 Windows 8)