Edit

Share via

SaferSetPolicyInformation function (winsafer.h)

  • Article

The SaferSetPolicyInformation function sets the global policy controls.

Syntax

BOOL SaferSetPolicyInformation(
  [in] DWORD                   dwScopeId,
  [in] SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in] DWORD                   InfoBufferSize,
  [in] PVOID                   InfoBuffer,
       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 set. The specified value determines the size and type of the InfoBuffer parameter. The following table shows the possible values.

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

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

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

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

InfoBuffer return type: DWORD.
SaferPolicyScopeFlags
5
 Sets 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.

[in] 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.

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)