Edit

Share via

SaferSetLevelInformation function (winsafer.h)

  • Article

The SaferSetLevelInformation function sets the information about a policy level.

Syntax

BOOL SaferSetLevelInformation(
  [in] SAFER_LEVEL_HANDLE      LevelHandle,
  [in] SAFER_OBJECT_INFO_CLASS dwInfoType,
  [in] LPVOID                  lpQueryBuffer,
  [in] DWORD                   dwInBufferSize
);

Parameters

[in] LevelHandle

The handle of the level to be set.

[in] dwInfoType

A SAFER_OBJECT_INFO_CLASS enumeration value that specifies the type of object information that should be set. The specified value determines the size and type of the lpQueryBuffer parameter. The following table shows the possible values.

Value Meaning
SaferObjectLevelId
1
 Sets the LEVELID constant.

lpQueryBuffer return type: DWORD.
SaferObjectScopeId
2
 Sets the user or machine scope.

lpQueryBuffer return type: DWORD.
SaferObjectFriendlyName
3
 Sets the display name.

lpQueryBuffer return type: LPCWSTR.
SaferObjectDescription
4
 Sets the description.

lpQueryBuffer return type: LPCWSTR.

[in] lpQueryBuffer

A buffer to contain the results of the query. For the type of the returned information for each possible value of the dwInfoType parameter, see the dwInfoType parameter.

[in] dwInBufferSize

The size, in bytes, of the lpQueryBuffer parameter.

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)