Condividi tramite


Funzione LsaQueryInformationPolicy (ntsecapi.h)

La funzione LsaQueryInformationPolicy recupera informazioni su un oggetto Policy .

Sintassi

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

Parametri

[in] PolicyHandle

Handle per un oggetto Policy . I diritti di accesso necessari per questo handle dipendono dal valore del parametro InformationClass . Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] InformationClass

Specifica uno dei valori seguenti dal tipo di enumerazione POLICY_INFORMATION_CLASS . Il valore indica il tipo di informazioni da recuperare.

Valore Significato
PolicyAuditEventsInformation
Recupera le regole di controllo del sistema. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_VIEW_AUDIT_INFORMATION. Il parametro Buffer riceve un puntatore a una struttura POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation
Recupera il nome e il SID del dominio primario del sistema. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_VIEW_LOCAL_INFORMATION. Il parametro Buffer riceve un puntatore a una struttura POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation
Recupera il nome e il SID del dominio dell'account del sistema. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_VIEW_LOCAL_INFORMATION. Il parametro Buffer riceve un puntatore a una struttura POLICY_ACCOUNT_DOMAIN_INFO .
PolicyLsaServerRoleInformation
Recupera il ruolo di un server LSA. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_VIEW_LOCAL_INFORMATION. Il parametro Buffer riceve un puntatore a una struttura POLICY_LSA_SERVER_ROLE_INFO .
PolicyModificationInformation
Recupera informazioni sull'ora di creazione e sull'ultima modifica del database LSA. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_VIEW_LOCAL_INFORMATION. Il parametro Buffer riceve un puntatore a una struttura POLICY_MODIFICATION_INFO .
PolicyDnsDomainInformation
Recupera le informazioni DNS (Domain Name System) sul dominio primario associato all'oggetto Policy . L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_VIEW_LOCAL_INFORMATION. Il parametro Buffer riceve un puntatore a una struttura POLICY_DNS_DOMAIN_INFO .

[out] Buffer

Puntatore a una variabile che riceve un puntatore a una struttura contenente le informazioni richieste. Il tipo di struttura dipende dal valore del parametro InformationClass .

Quando le informazioni non sono più necessarie, passare il puntatore restituito a LsaFreeMemory.

Valore restituito

Se la funzione LsaQueryInformationPolicy ha esito positivo, il valore restituito viene STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS. Per altre informazioni, vedere Valori restituiti della funzione criteri LSA.

È possibile utilizzare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.

Commenti

Per un esempio che illustra la chiamata a questa funzione, vedere Gestione delle informazioni sui criteri.

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 ntsecapi.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

LsaFreeMemory

LsaSetInformationPolicy

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_INFORMATION_CLASS

POLICY_LSA_SERVER_ROLE_INFO

POLICY_MODIFICATION_INFO

POLICY_PRIMARY_DOMAIN_INFO