Fungsi panggilan balik CallWndProc

Artikel
07/01/2023

Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi SetWindowsHookExA/SetWindowsHookExW . Sistem memanggil fungsi ini sebelum memanggil prosedur jendela untuk memproses pesan yang dikirim ke utas.

Jenis HOOKPROC mendefinisikan penunjuk ke fungsi panggilan balik ini. CallWndProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi atau yang ditentukan pustaka.

Sintaks

LRESULT CALLBACK CallWndProc(
  _In_ int    nCode,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

Parameter

nCode [in]
Jenis: int

Menentukan apakah prosedur kait harus memproses pesan. Jika nCodeHC_ACTION, prosedur kait harus memproses pesan. Jika nCode kurang dari nol, prosedur hook harus meneruskan pesan ke fungsi CallNextHookEx tanpa pemrosesan lebih lanjut dan harus mengembalikan nilai yang dikembalikan oleh CallNextHookEx.
wParam [in]
Jenis: WPARAM

Menentukan apakah pesan dikirim oleh utas saat ini. Jika pesan dikirim oleh utas saat ini, pesan tersebut bukan nol; jika tidak, itu adalah nol.
lParam [in]
Jenis: LPARAM

Penunjuk ke struktur CWPSTRUCT yang berisi detail tentang pesan.

Menampilkan nilai

Jenis:****

Jenis: LRESULT

Jika nCode kurang dari nol, prosedur hook harus mengembalikan nilai yang dikembalikan oleh CallNextHookEx.

Jika nCode lebih besar dari atau sama dengan nol, sangat disarankan agar Anda memanggil CallNextHookEx dan mengembalikan nilai yang dikembalikannya; jika tidak, aplikasi lain yang telah menginstal kait WH_CALLWNDPROC tidak akan menerima pemberitahuan kait dan mungkin bertingkah salah sebagai akibatnya. Jika prosedur hook tidak memanggil CallNextHookEx, nilai yang dikembalikan harus nol.

Keterangan

Prosedur hook CallWndProc dapat memeriksa pesan, tetapi tidak dapat mengubahnya. Setelah prosedur kait mengembalikan kontrol ke sistem, pesan diteruskan ke prosedur jendela.

Aplikasi menginstal prosedur kait dengan menentukan jenis kait WH_CALLWNDPROC dan penunjuk ke prosedur kait dalam panggilan ke fungsi SetWindowsHookExA/SetWindowsHookExW .

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)