NotifyChangeEventLog-Funktion (winbase.h)

Artikel
08/27/2023

Ermöglicht es einer Anwendung, Benachrichtigungen zu empfangen, wenn ein Ereignis in das angegebene Ereignisprotokoll geschrieben wird. Wenn das Ereignis in das Protokoll geschrieben wird, wird das angegebene Ereignisobjekt auf den signalierten Zustand festgelegt.

Syntax

BOOL NotifyChangeEventLog(
  [in] HANDLE hEventLog,
  [in] HANDLE hEvent
);

Parameter

[in] hEventLog

Ein Handle für ein Ereignisprotokoll. Die OpenEventLog-Funktion gibt dieses Handle zurück.

[in] hEvent

Ein Handle für ein Ereignisobjekt, das manuell zurückgesetzt oder automatisch zurückgesetzt wird. Verwenden Sie die CreateEvent-Funktion , um das Ereignisobjekt zu erstellen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die NotifyChangeEventLog-Funktion funktioniert nicht mit Remotehandles. Wenn der hEventLog-Parameter das Handle für ein Ereignisprotokoll auf einem Remotecomputer ist, gibt NotifyChangeEventLog null zurück, und GetLastError gibt ERROR_INVALID_HANDLE zurück.

Wenn der Thread nicht auf das Ereignis wartet, wenn das System PulseEvent aufruft, empfängt der Thread die Benachrichtigung nicht. Daher sollten Sie einen separaten Thread erstellen, um auf Benachrichtigungen zu warten.

Das System benachrichtigt Sie weiterhin über Änderungen, bis Sie das Handle für das Ereignisprotokoll schließen. Verwenden Sie zum Schließen des Ereignisprotokolls die Funktion CloseEventLog oder DeregisterEventSource .

Beispiele

Ein Beispiel finden Sie unter Empfangen von Ereignisbenachrichtigungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll
APIs	ext-ms-win-advapi32-eventlog-l1-1-1 (eingeführt in Windows 10, Version 10.0.10240)