Fungsi NotifyChangeEventLog (winbase.h)

Artikel
03/13/2024

Memungkinkan aplikasi menerima pemberitahuan saat peristiwa ditulis ke log peristiwa yang ditentukan. Saat peristiwa ditulis ke log, objek peristiwa yang ditentukan diatur ke status yang disinyalkan.

Sintaks

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

Parameter

[in] hEventLog

Handel ke log peristiwa. Fungsi OpenEventLog mengembalikan handel ini.

[in] hEvent

Handel ke objek peristiwa reset manual atau reset otomatis. Gunakan fungsi CreateEvent untuk membuat objek peristiwa.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi NotifyChangeEventLog tidak berfungsi dengan handel jarak jauh. Jika parameter hEventLog adalah handel ke log peristiwa di komputer jarak jauh, NotifyChangeEventLog mengembalikan nol, dan GetLastError mengembalikan ERROR_INVALID_HANDLE.

Jika utas tidak menunggu peristiwa ketika sistem memanggil PulseEvent, utas tidak akan menerima pemberitahuan. Oleh karena itu, Anda harus membuat utas terpisah untuk menunggu pemberitahuan.

Sistem akan terus memberi tahu Anda tentang perubahan hingga Anda menutup handel ke log peristiwa. Untuk menutup log peristiwa, gunakan fungsi CloseEventLog atau DeregisterEventSource .

Contoh

Misalnya, lihat Menerima Pemberitahuan Peristiwa.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll
Set API	ext-ms-win-advapi32-eventlog-l1-1-1 (diperkenalkan dalam Windows 10, versi 10.0.10240)