Partager via


LsaQueryInformationPolicy, fonction (ntsecapi.h)

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

Voir aussi

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