Funzione LsaQueryInformationPolicy (ntsecapi.h)

Articolo
03/05/2024

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