LsaRegisterPolicyChangeNotification-Funktion (ntsecapi.h)

Artikel
03/04/2024

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

Freigeben über