Share via

LsaSetInformationPolicy, fonction (ntsecapi.h)

  • Article

La fonction LsaSetInformationPolicy modifie les informations d’un objet Policy .

Syntaxe

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] 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 à définir.

Valeur Signification
PolicyAuditEventsInformation
 Définit les règles d’audit du système. Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_SET_AUDIT_REQUIREMENTS. Le paramètre Buffer doit être un pointeur vers une structure POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation
 Définit 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_TRUST_ADMIN. Le paramètre Buffer doit être un pointeur vers une structure POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation
 Définit 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_TRUST_ADMIN. Le paramètre Buffer doit être un pointeur vers une structure POLICY_ACCOUNT_DOMAIN_INFO .
PolicyDnsDomainInformation
 Définit 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_TRUST_ADMIN. Le paramètre Buffer doit être un pointeur vers une structure POLICY_DNS_DOMAIN_INFO .
PolicyLsaServerRoleInformation
 Définit le rôle d’un serveur LSA. Le handle passé dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_SERVER_ADMIN. Le paramètre Buffer doit être un pointeur vers une structure POLICY_LSA_SERVER_ROLE_INFO .

La modification du rôle d’un serveur de principal à la sauvegarde n’a aucun effet (bien que la fonction retourne STATUS_SUCCESS). La modification du rôle d’un serveur de sauvegarde en serveur principal nécessite des opérations réseau étendues et peut être lente.

[in] Buffer

Pointeur vers une structure contenant les informations à définir. Le type de structure dépend de la valeur du paramètre InformationClass .

Valeur retournée

Si la fonction 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.

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

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO