LSA_REGISTER_NOTIFICATION Rückruffunktion (ntsecpkg.h)

Artikel
02/29/2024

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

Freigeben über