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