Fungsi UnhookWinEvent (winuser.h)

Menghapus fungsi hook peristiwa yang dibuat oleh panggilan sebelumnya ke SetWinEventHook.

Sintaks

BOOL UnhookWinEvent(
  [in] HWINEVENTHOOK hWinEventHook
);

Parameter

[in] hWinEventHook

Jenis: HWINEVENTHOOK

Tangani ke hook peristiwa yang dikembalikan dalam panggilan sebelumnya ke SetWinEventHook.

Nilai kembali

Jenis: BOOL

Jika berhasil, mengembalikan TRUE; jika tidak, mengembalikan FALSE.

Tiga kesalahan umum menyebabkan fungsi ini gagal:

• Parameter hWinEventHook adalah NULL atau tidak valid.
• Hook peristiwa yang ditentukan oleh hWinEventHook sudah dihapus.
• UnhookWinEvent dipanggil dari utas yang berbeda dari panggilan asli ke SetWinEventHook.

Keterangan

Fungsi ini menghapus hook peristiwa yang ditentukan oleh hWinEventHook yang mencegah fungsi panggilan balik yang sesuai menerima pemberitahuan peristiwa lebih lanjut. Jika utas klien berakhir, sistem secara otomatis memanggil fungsi ini.

Panggil fungsi ini dari utas yang sama yang menginstal hook peristiwa. UnhookWinEvent gagal jika dipanggil dari utas yang berbeda dari panggilan yang sesuai dengan SetWinEventHook.

Jika WINEVENT_INCONTEXT ditentukan ketika hook peristiwa ini diinstal, sistem mencoba untuk membongkar DLL yang sesuai dari semua proses yang memuatnya. Meskipun pembongkaran tidak segera terjadi, fungsi kait tidak dipanggil setelah UnhookWinEvent kembali. Untuk informasi selengkapnya tentang WINEVENT_INCONTEXT, lihat Fungsi Kait Dalam Konteks.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Redistribusi	Aksesibilitas Aktif 1.3 RDK di Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95