LsaRegisterPolicyChangeNotification, fonction (ntsecapi.h)

Article
03/06/2024

La fonction LsaRegisterPolicyChangeNotification inscrit un handle d’événement auprès de l’autorité de sécurité locale (LSA). Ce handle d’événement est signalé chaque fois que la stratégie LSA indiquée est modifiée.

Syntaxe

NTSTATUS LsaRegisterPolicyChangeNotification(
  [in] POLICY_NOTIFICATION_INFORMATION_CLASS InformationClass,
  [in] HANDLE                                NotificationEventHandle
);

Paramètres

[in] InformationClass

Valeur POLICY_NOTIFICATION_INFORMATION_CLASS qui spécifie le type de modifications de stratégie dont votre application sera avertie. Spécifiez l’une des valeurs suivantes.

Valeur	Signification
PolicyNotifyAuditEventsInformation	Auditer les modifications de stratégie.
PolicyNotifyAccountDomainInformation	Modifications des informations de domaine de compte.
PolicyNotifyServerRoleInformation	Changements de rôle de serveur.
PolicyNotifyDomainEfsInformation	Modifications des informations de stratégie EFS.
PolicyNotifyDomainKerberosTicketInformation	Modifications des informations de stratégie de ticket Kerberos.
PolicyNotifyDnsDomainInformation	Informations DNS (Domain Name System), nom ou SID des modifications de domaine principal du système.

[in] NotificationEventHandle

Handle pour un événement obtenu en appelant la fonction CreateEvent . L’événement peut être nommé ou sans nom.

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.

Remarques

Lorsque vous avez terminé d’utiliser un événement de notification qui a été inscrit par la fonction LsaRegisterPolicyChangeNotification , annulez son inscription en appelant la fonction LsaUnregisterPolicyChangeNotification .

Pour obtenir un exemple illustrant l’appel de cette fonction, consultez Réception d’événements de modification 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	Secur32.lib
DLL	Secur32.dll

Voir aussi

LsaUnregisterPolicyChangeNotification

Partager via