Export (0) Print
Expand All

SaferGetLevelInformation function

The SaferGetLevelInformation function retrieves information about a policy level.

Syntax


BOOL WINAPI SaferGetLevelInformation(
  _In_       SAFER_LEVEL_HANDLE LevelHandle,
  _In_       SAFER_OBJECT_INFO_CLASS dwInfoType,
  _Out_opt_  LPVOID lpQueryBuffer,
  _In_       DWORD dwInBufferSize,
  _Out_      LPDWORD lpdwOutBufferSize
);

Parameters

LevelHandle [in]

The handle of the level to be queried.

dwInfoType [in]

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

ValueMeaning
SaferObjectLevelId
1

Queries for the LEVELID constant.

lpQueryBuffer return type: DWORD.

SaferObjectScopeId
2

Queries for the user or machine scope.

lpQueryBuffer return type: DWORD.

SaferObjectFriendlyName
3

Queries for the display name.

lpQueryBuffer return type: LPCWSTR.

SaferObjectDescription
4

Queries for the description.

lpQueryBuffer return type: LPCWSTR.

 

lpQueryBuffer [out, optional]

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.

dwInBufferSize [in]

The size of the lpQueryBuffer parameter in bytes.

lpdwOutBufferSize [out]

A pointer to return the output size of the lpQueryBuffer parameter.

Return value

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

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinSafer.h

Library

Advapi32.lib

DLL

Advapi32.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft