Funzione SaferGetLevelInformation (winsafer.h)

La funzione SaferGetLevelInformation recupera informazioni su un livello di criteri.

Sintassi

BOOL SaferGetLevelInformation(
  [in]            SAFER_LEVEL_HANDLE      LevelHandle,
  [in]            SAFER_OBJECT_INFO_CLASS dwInfoType,
  [out, optional] LPVOID                  lpQueryBuffer,
  [in]            DWORD                   dwInBufferSize,
  [out]           LPDWORD                 lpdwOutBufferSize
);

Parametri

[in] LevelHandle

Handle del livello da eseguire query.

[in] dwInfoType

Valore di enumerazione SAFER_OBJECT_INFO_CLASS che specifica il tipo di informazioni sull'oggetto da restituire. Il valore specificato determina le dimensioni e il tipo del parametro lpQueryBuffer . Nella tabella seguente sono illustrati i possibili valori.

Valore	Significato
SaferObjectLevelId 1	Query per la costante LEVELID. tipo restituito lpQueryBuffer: DWORD.
SaferObjectScopeId 2	Query per l'ambito utente o computer. tipo restituito lpQueryBuffer: DWORD.
SaferObjectFriendlyName 3	Query per il nome visualizzato. Tipo restituito lpQueryBuffer: LPCWSTR.
SaferObjectDescription 4	Query per la descrizione. Tipo restituito lpQueryBuffer: LPCWSTR.

[out, optional] lpQueryBuffer

Buffer che contiene i risultati della query. Per il tipo delle informazioni restituite per ogni valore possibile del parametro dwInfoType , vedere il parametro dwInfoType .

[in] dwInBufferSize

Dimensioni del parametro lpQueryBuffer in byte.

[out] lpdwOutBufferSize

Puntatore per restituire le dimensioni di output del parametro lpQueryBuffer .

Valore restituito

TRUE se la funzione ha esito positivo; in caso contrario, FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsafer.h
Libreria	Advapi32.lib
DLL	Advapi32.dll
Set di API	ext-ms-win-advapi32-safer-l1-1-0 (introdotto in Windows 8)