SaferIdentifyLevel function (winsafer.h)

The SaferIdentifyLevel function retrieves information about a level.

Syntax

BOOL SaferIdentifyLevel(
  [in]           DWORD                  dwNumProperties,
  [in, optional] PSAFER_CODE_PROPERTIES pCodeProperties,
  [out]          SAFER_LEVEL_HANDLE     *pLevelHandle,
                 LPVOID                 lpReserved
);

Parameters

[in] dwNumProperties

Number of SAFER_CODE_PROPERTIES structures in the pCodeproperties parameter.

[in, optional] pCodeProperties

Array of SAFER_CODE_PROPERTIES structures. Each structure contains a code file to be checked and the criteria used to check the file.

[out] pLevelHandle

The returned SAFER_LEVEL_HANDLE. When you have finished using the handle, close it by calling the SaferCloseLevel function.

lpReserved

Reserved for future use. Should be set to NULL.

Beginning with Windows 8 and Windows Server 2012 SRP_POLICY_APPX is defined as Windows Store app.

Return value

TRUE if a SAFER_LEVEL_HANDLE was opened; 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)