LsaRegisterPolicyChangeNotification-Funktion (ntsecapi.h)

Die LsaRegisterPolicyChangeNotification-Funktion registriert ein Ereignishandle bei der lokalen Sicherheitsautorität (LSA). Dieses Ereignishandle wird immer dann signalisiert, wenn die angegebene LSA-Richtlinie geändert wird.

Syntax

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

Parameter

[in] InformationClass

Ein POLICY_NOTIFICATION_INFORMATION_CLASS Wert, der den Typ der Richtlinienänderungen angibt, über die Ihre Anwendung benachrichtigt wird. Geben Sie einen der folgenden Werte an.

[in] NotificationEventHandle

Ein Handle für ein Ereignis, das durch Aufrufen der CreateEvent-Funktion abgerufen wird. Das Ereignis kann entweder benannt oder unbenannt sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.

Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Hinweise

Wenn Sie die Verwendung eines Benachrichtigungsereignisses abgeschlossen haben, das von der LsaRegisterPolicyChangeNotification-Funktion registriert wurde, heben Sie die Registrierung auf, indem Sie die LsaUnregisterPolicyChangeNotification-Funktion aufrufen.

Ein Beispiel, das den Aufruf dieser Funktion veranschaulicht, finden Sie unter Empfangen von Richtlinienänderungsereignissen.

Anforderungen

Weitere Informationen

LsaUnregisterPolicyChangeNotification