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
Library Advapi32.lib
[DLL] Advapi32.dll
API セット ext-ms-win-advapi32-safer-l1-1-0 (Windows 8 で導入)