Edit

Share via

SaferGetPolicyInformation function (winsafer.h)

  • Article

The SaferGetPolicyInformation function gets information about a policy. You can query to find out more information about the policy.

Syntax

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

Parameters

[in] dwScopeId

The scope of the query. The following table shows the possible values.

Value Meaning
SAFER_SCOPEID_MACHINE
1
 The scope of the query is by computer.
SAFER_SCOPEID_USER
2
 The scope of the query is by user.

[in] SaferPolicyInfoClass

A SAFER_POLICY_INFO_CLASS enumeration value that specifies the type of policy information that should be returned. The specified value determines the size and type of the InfoBuffer parameter. The following table shows the possible values.

Value Meaning
SaferPolicyLevelList
1
 Queries for the list of all levels defined in a policy.

InfoBuffer return type: DWORD array of LevelIds.
SaferPolicyEnableTransparentEnforcement
2
 Queries for the policy value to determine whether DLL checking is enabled.

InfoBuffer return type: DWORD Boolean.
SaferPolicyDefaultLevel
3
 Queries for the default policy level.

InfoBuffer return type: DWORD LevelId.
SaferPolicyEvaluateUserScope
4
 Queries to determine whether user scope rules should be consulted during policy evaluation.

InfoBuffer return type: DWORD.
SaferPolicyScopeFlags
5
 Queries to determine whether the policy is to skip members of the local administrators group.

InfoBuffer return type: DWORD.

[in] InfoBufferSize

The size, in bytes, of the InfoBuffer parameter.

[out] InfoBuffer

A buffer to contain the results of the query. The size and type of the returned information is determined by the SaferPolicyInfoClass parameter. For the type of the returned information for each possible value of the SaferPolicyInfoClass parameter, see the SaferPolicyInfoClass parameter.

[out] InfoBufferRetSize

The number of bytes in the InfoBuffer parameter that were filled with policy information.

lpReserved

Reserved for future use. This parameter should be set to NULL.

Return value

TRUE if the function succeeds; otherwise, FALSE. For extended error information, call GetLastError.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header winsafer.h
Library Advapi32.lib
DLL Advapi32.dll
API set ext-ms-win-advapi32-safer-l1-1-0 (introduced in Windows 8)