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.

Wert Bedeutung
PolicyNotifyAuditEventsInformation
Überwachen von Richtlinienänderungen.
PolicyNotifyAccountDomainInformation
Änderungen der Kontodomäneninformationen.
PolicyNotifyServerRoleInformation
Serverrollenänderungen.
PolicyNotifyDomainEfsInformation
Änderungen an EFS-Richtlinieninformationen.
PolicyNotifyDomainKerberosTicketInformation
Änderungen an Den Richtlinieninformationen für Kerberos-Tickets.
PolicyNotifyDnsDomainInformation
DNS-Informationen (Domain Name System), Name oder SID der änderungen der primären Domäne des Systems.

[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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecapi.h
Bibliothek Secur32.lib
DLL Secur32.dll

Weitere Informationen

LsaUnregisterPolicyChangeNotification