LsaSetInformationPolicy, fonction (ntsecapi.h)
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 |
|---|---|
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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 |