Funzione SaferGetPolicyInformation (winsafer.h)

  • Articolo

La funzione SaferGetPolicyInformation ottiene informazioni su un criterio. È possibile eseguire una query per altre informazioni sui criteri.

Sintassi

BOOL SaferGetPolicyInformation(
  [in]  DWORD                   dwScopeId,
  [in]  SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in]  DWORD                   InfoBufferSize,
  [out] PVOID                   InfoBuffer,
  [out] PDWORD                  InfoBufferRetSize,
        LPVOID                  lpReserved
);

Parametri

[in] dwScopeId

Ambito della query. Nella tabella seguente sono illustrati i possibili valori.

Valore Significato
SAFER_SCOPEID_MACHINE
1
 L'ambito della query è per computer.
SAFER_SCOPEID_USER
2
 L'ambito della query è per utente.

[in] SaferPolicyInfoClass

Valore di enumerazione SAFER_POLICY_INFO_CLASS che specifica il tipo di informazioni sui criteri che devono essere restituite. Il valore specificato determina le dimensioni e il tipo del parametro InfoBuffer . Nella tabella seguente sono illustrati i possibili valori.

Valore Significato
SaferPolicyLevelList
1
 Query per l'elenco di tutti i livelli definiti in un criterio.

Tipo restituito di InfoBuffer: matrice DWORD di LevelIds.
SaferPolicyEnableTransparentEnforcement
2
 Query per il valore dei criteri per determinare se il controllo DLL è abilitato.

Tipo restituito di InfoBuffer: Boolean DWORD.
SaferPolicyDefaultLevel
3
 Query per il livello di criterio predefinito.

Tipo restituito infoBuffer: DWORD LevelId.
SaferPolicyEvaluateUserScope
4
 Query per determinare se le regole dell'ambito utente devono essere visualizzate durante la valutazione dei criteri.

Tipo restituito infoBuffer: DWORD.
SaferPolicyScopeFlags
5
 Query per determinare se i criteri devono ignorare i membri del gruppo amministratori locali.

Tipo restituito infoBuffer: DWORD.

[in] InfoBufferSize

Dimensioni, in byte, del parametro InfoBuffer .

[out] InfoBuffer

Buffer che contiene i risultati della query. Le dimensioni e il tipo delle informazioni restituite sono determinati dal parametro SaferPolicyInfoClass . Per il tipo delle informazioni restituite per ogni valore possibile del parametro SaferPolicyInfoClass, vedere il parametro SaferPolicyInfoClass.

[out] InfoBufferRetSize

Numero di byte nel parametro InfoBuffer riempito con informazioni sui criteri.

lpReserved

Riservato per utilizzi futuri. Questo parametro deve essere impostato su NULL.

Valore restituito

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

Requisiti

   
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)