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 時未等候事件，線程將不會收到通知。 因此，您應該建立個別的線程來等候通知。

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

範例

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

規格需求

另請參閱

CloseEventLog

CreateEvent

DeregisterEventSource

事件記錄函式

OpenEventLog