共用方式為


winbase.h (NotifyChangeEventLog 函式)

可讓應用程式在事件寫入指定的事件記錄檔時接收通知。 當事件寫入記錄檔時,指定的事件物件會設定為已發出訊號的狀態。

語法

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

參數

[in] hEventLog

事件記錄檔的句柄。 OpenEventLog 函式會傳回這個句柄。

[in] hEvent

手動重設或自動重設事件物件的句柄。 使用 CreateEvent 函式來建立事件物件。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

NotifyChangeEventLog 函式不適用於遠端句柄。 如果 hEventLog 參數是遠端電腦上的事件記錄檔句柄, NotifyChangeEventLog 會傳回零,而 GetLastError傳回ERROR_INVALID_HANDLE

如果線程在系統呼叫 PulseEvent 時未等候事件,線程將不會收到通知。 因此,您應該建立個別的線程來等候通知。

系統會繼續通知您變更,直到關閉事件記錄檔的句柄為止。 若要關閉事件記錄檔,請使用 CloseEventLogDeregisterEventSource 函式。

範例

如需範例,請參閱 接收事件通知

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll
API 集合 ext-ms-win-advapi32-eventlog-l1-1-1 (Windows 10 10.0.10240 版)

另請參閱

CloseEventLog

CreateEvent

DeregisterEventSource

事件記錄函式

OpenEventLog