LSA_REGISTER_NOTIFICATION Rückruffunktion (ntsecpkg.h)

  • Artikel

Stellt einen Mechanismus bereit, bei dem das Sicherheitspaket benachrichtigt wird. Benachrichtigungen können in festen Intervallen erfolgen, wenn ein Ereignisobjekt signalisiert wird, oder während bestimmter Systemereignisse.

Syntax

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
)
{...}

Parameter

[in] StartFunction

Die Funktion, die aufgerufen wird, um Benachrichtigungen zu akzeptieren.

[in] Parameter

Das Argument der Im Parameter StartFunction angegebenen Funktion.

[in] NotificationType

Gibt den Typ der Benachrichtigung an. In der folgenden Tabelle sind die gültigen Werte aufgeführt.

Wert Bedeutung
NOTIFIER_TYPE_INTERVAL
 Benachrichtigen Sie in festen Intervallen. Verwenden Sie den Parameter IntervalMinutes , um die Intervalllänge anzugeben.
NOTIFIER_TYPE_HANDLE_WAIT
 Benachrichtigen Sie, wenn das vom WaitEvent-Parameter angegebene Ereignishandle signalisiert wird.
NOTIFIER_TYPE_STATE_CHANGE
 Benachrichtigen Sie, wenn sich die Domäne oder der Installationstyp des Computers geändert hat.
NOTIFIER_TYPE_NOTIFY_EVENT
 Benachrichtigen, wenn ein Sicherheitsereignis stattfindet. Verwenden Sie den NotificationClass-Parameter , um das ereignis von Interesse anzugeben.
NOTIFIER_TYPE_IMMEDIATE
 Benachrichtigen Sie sofort. Dieser Wert impliziert NOTIFIER_FLAG_ONE_SHOT.

[in] NotificationClass

Gibt die Klasse von Ereignissen an, die Benachrichtigungen generieren. Geben Sie null an, es sei denn, der NotificationType-Parameter ist auf NOTIFIER_TYPE_NOTIFY_EVENT festgelegt.

Wert Bedeutung
NOTIFY_CLASS_PACKAGE_CHANGE
 Ein Paket wurde geladen, oder ein neues Paket wurde als bevorzugtes Paket ausgewählt. Weitere Informationen finden Sie in den Hinweisen.
NOTIFY_CLASS_ROLE_CHANGE
 Für die interne Verwendung reserviert.
NOTIFY_CLASS_DOMAIN_CHANGE
 Für die interne Verwendung reserviert.

[in] NotificationFlags

Gibt Flags an, die das Benachrichtigungsverhalten steuern.

Wert Bedeutung
NOTIFIER_FLAG_NEW_THREAD
 Warten Sie mithilfe eines neuen Threads auf eine Benachrichtigung.
NOTIFIER_FLAG_ONE_SHOT
 Nur einmal benachrichtigen.
NOTIFIER_FLAG_SECONDS
 Der Parameter IntervalMinutes gibt Sekunden an.

[in] IntervalMinutes

Gibt die Zeitverzögerung zwischen Benachrichtigungen an.

[in] WaitEvent

Optional. Behandeln eines Ereignisobjekts. Wenn das Objekt signalisiert wird, erfolgt die Benachrichtigung. Dieser Wert wird in Verbindung mit dem NotificationType-Wert NOTIFIER_TYPE_HANDLE_WAIT verwendet.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Benachrichtigung.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Wenn Sie den NOTIFY_CLASS_PACKAGE_CHANGE Wert für den NotificationClass-Parameter angeben, stellen die folgenden Werte gültige Änderungen dar.

Wert BESCHREIBUNG
SECPKG_PACKAGE_CHANGE_LOAD Ein Paket wurde geladen.
SECPKG_PACKAGE_CHANGE_UNLOAD Ein Paket wurde entladen.
SECPKG_PACKAGE_CHANGE_SELECT Ein neues Paket wurde zum bevorzugten Sicherheitspaket.
 

Ein Zeiger auf die Funktion RegisterNotification ist in der LSA_SECPKG_FUNCTION_TABLE Struktur verfügbar, die von der SpInitialize-Funktion empfangen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecpkg.h

Weitere Informationen

LSA_SECPKG_FUNCTION_TABLE

SpInitialize