LsaQueryInformationPolicy, fonction (ntsecapi.h)

Article
08/25/2023

La fonction LsaQueryInformationPolicy récupère des informations sur un objet Policy .

Syntaxe

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

Paramètres

[in] PolicyHandle

Handle d’un objet Policy . Les droits d’accès requis pour ce handle dépendent de la valeur du paramètre InformationClass . Pour plus d’informations, consultez Ouverture d’un handle d’objet de stratégie.

[in] InformationClass

Spécifie l’une des valeurs suivantes du type d’énumération POLICY_INFORMATION_CLASS . La valeur indique le type d’informations à récupérer.

Valeur	Signification
PolicyAuditEventsInformation	Récupère les règles d’audit du système. Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_VIEW_AUDIT_INFORMATION. Le paramètre Buffer reçoit un pointeur vers une structure POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation	Récupère le nom et le SID du domaine principal du système. Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_VIEW_LOCAL_INFORMATION. Le paramètre Buffer reçoit un pointeur vers une structure POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation	Récupère le nom et le SID du domaine de compte du système. Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_VIEW_LOCAL_INFORMATION. Le paramètre Buffer reçoit un pointeur vers une structure POLICY_ACCOUNT_DOMAIN_INFO .
PolicyLsaServerRoleInformation	Récupère le rôle d’un serveur LSA. Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_VIEW_LOCAL_INFORMATION. Le paramètre Buffer reçoit un pointeur vers une structure POLICY_LSA_SERVER_ROLE_INFO .
PolicyModificationInformation	Récupère des informations sur l’heure de création et la dernière modification de la base de données LSA. Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_VIEW_LOCAL_INFORMATION. Le paramètre Buffer reçoit un pointeur vers une structure POLICY_MODIFICATION_INFO .
PolicyDnsDomainInformation	Récupère les informations DNS (Domain Name System) sur le domaine principal associé à l’objet Policy . Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_VIEW_LOCAL_INFORMATION. Le paramètre Buffer reçoit un pointeur vers une structure POLICY_DNS_DOMAIN_INFO .

[out] Buffer

Pointeur vers une variable qui reçoit un pointeur vers une structure contenant les informations demandées. Le type de structure dépend de la valeur du paramètre InformationClass .

Lorsque vous n’avez plus besoin des informations, passez le pointeur retourné à LsaFreeMemory.

Valeur retournée

Si la fonction LsaQueryInformationPolicy réussit, la valeur de retour est STATUS_SUCCESS.

Si la fonction échoue, la valeur de retour est un code NTSTATUS. Pour plus d’informations, consultez Valeurs de retour de la fonction de stratégie LSA.

Vous pouvez utiliser la fonction LsaNtStatusToWinError pour convertir le code NTSTATUS en code d’erreur Windows.

Remarques

Pour obtenir un exemple illustrant l’appel de cette fonction, consultez Gestion des informations de stratégie.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ntsecapi.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll