NotifyChangeEventLog

指定したイベントログにイベントが書き込まれたときにアプリケーションが通知を受け取れるようにする。

NotifyChangeEventLog hEventLog, hEvent

hEventLog : [intptr] イベントログへのハンドル。OpenEventLog 関数がこのハンドルを返す。
hEvent : [intptr] 手動リセットまたは自動リセットイベントオブジェクトへのハンドル。イベントオブジェクトの作成には CreateEvent 関数を使用する。

(プラグイン / モジュール : advapi32.dll)

解説

指定したイベントログにイベントが書き込まれたときにアプリケーションが通知を受け取れるようにする。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。
関数が失敗した場合、戻り値は 0 である。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
NotifyChangeEventLog 関数はリモートハンドルでは動作しない。hEventLog
パラメータがリモートコンピュータ上のイベントログへのハンドルの場合、NotifyChangeEventLog は 0
を返し、GetLastError は ERROR_INVALID_HANDLE を返す。システムが PulseEvent
を呼び出したときにスレッドがイベントで待機していない場合、スレッドは通知を受け取らない。したがって、通知を待つために別のスレッドを作成するべきである。イベントログへのハンドルを閉じるまで、システムは変更の通知を続ける。イベントログを閉じるには
CloseEventLog または DeregisterEventSource 関数を使用する。

情報