LSA_REGISTER_NOTIFICATION fonction de rappel (ntsecpkg.h)

Article
02/29/2024

Fournit un mécanisme par lequel le package de sécurité est notifié. La notification peut se produire à intervalles fixes, lorsqu’un objet événement est signalé ou pendant certains événements système.

Syntaxe

LSA_REGISTER_NOTIFICATION LsaRegisterNotification;

HANDLE LsaRegisterNotification(
  [in] SEC_THREAD_START StartFunction,
  [in] PVOID Parameter,
  [in] ULONG NotificationType,
  [in] ULONG NotificationClass,
  [in] ULONG NotificationFlags,
  [in] ULONG IntervalMinutes,
  [in] HANDLE WaitEvent
)
{...}

Paramètres

[in] StartFunction

Fonction appelée pour accepter la notification.

[in] Parameter

Argument de la fonction spécifiée dans le paramètre StartFunction .

[in] NotificationType

Spécifie le type de notification. Le tableau suivant répertorie les valeurs valides.

Valeur	Signification
NOTIFIER_TYPE_INTERVAL	Notifier à intervalles fixes. Utilisez le paramètre IntervalMinutes pour indiquer la longueur de l’intervalle.
NOTIFIER_TYPE_HANDLE_WAIT	Informez quand le handle d’événement spécifié par le paramètre WaitEvent est signalé.
NOTIFIER_TYPE_STATE_CHANGE	Informez en cas de modification du domaine ou du type d’installation de la machine.
NOTIFIER_TYPE_NOTIFY_EVENT	Avertir lorsqu’un événement de sécurité a lieu. Utilisez le paramètre NotificationClass pour spécifier l’événement d’intérêt.
NOTIFIER_TYPE_IMMEDIATE	Informez immédiatement. Cette valeur implique NOTIFIER_FLAG_ONE_SHOT.

[in] NotificationClass

Spécifie la classe d’événements qui génèrent des notifications. Spécifiez zéro, sauf si le paramètre NotificationType est défini sur NOTIFIER_TYPE_NOTIFY_EVENT.

Valeur	Signification
NOTIFY_CLASS_PACKAGE_CHANGE	Un package a été chargé ou un nouveau package a été sélectionné comme package par défaut. Pour plus d'informations, consultez la section Notes.
NOTIFY_CLASS_ROLE_CHANGE	Réservé à un usage interne.
NOTIFY_CLASS_DOMAIN_CHANGE	Réservé à un usage interne.

[in] NotificationFlags

Spécifie les indicateurs qui contrôlent le comportement des notifications.

Valeur	Signification
NOTIFIER_FLAG_NEW_THREAD	Attendez la notification à l’aide d’un nouveau thread.
NOTIFIER_FLAG_ONE_SHOT	N’avertir qu’une seule fois.
NOTIFIER_FLAG_SECONDS	Le paramètre IntervalMinutes spécifie les secondes.

[in] IntervalMinutes

Spécifie le délai entre les notifications.

[in] WaitEvent

facultatif. Handle vers un objet d’événement. Lorsque l’objet est signalé, la notification se produit. Cette valeur est utilisée conjointement avec la valeur NotificationType NOTIFIER_TYPE_HANDLE_WAIT.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour la notification.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

Si vous spécifiez la valeur NOTIFY_CLASS_PACKAGE_CHANGE pour le paramètre NotificationClass , les valeurs suivantes représentent les modifications valides.

Valeur	Description
SECPKG_PACKAGE_CHANGE_LOAD	Un package a été chargé.
SECPKG_PACKAGE_CHANGE_UNLOAD	Un package a été déchargé.
SECPKG_PACKAGE_CHANGE_SELECT	Un nouveau package est devenu le package de sécurité préféré.

Un pointeur vers la fonction RegisterNotification est disponible dans la structure LSA_SECPKG_FUNCTION_TABLE reçue par la fonction SpInitialize .

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	ntsecpkg.h

Voir aussi

LSA_SECPKG_FUNCTION_TABLE

SpInitialize

Partager via