Fungsi SysMsgProc

Artikel
07/01/2023

Deskripsi

Fungsi panggilan balik yang ditentukan aplikasi atau yang ditentukan pustaka yang digunakan dengan fungsi SetWindowsHookExA/SetWindowsHookExW . Sistem memanggil fungsi ini setelah peristiwa input terjadi dalam kotak dialog, kotak pesan, menu, atau bilah gulir, tetapi sebelum pesan yang dihasilkan oleh peristiwa input diproses. Fungsi ini dapat memantau pesan untuk kotak dialog, kotak pesan, menu, atau bilah gulir apa pun di sistem.

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

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

Parameter

nCode [in]

Jenis: int

Jenis peristiwa input yang menghasilkan 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.

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
MSGF_DIALOGBOX 0	Peristiwa input terjadi dalam kotak pesan atau kotak dialog.
MSGF_MENU 2	Peristiwa input terjadi di menu.
MSGF_SCROLLBAR 5	Peristiwa input terjadi di bilah gulir.

wParam

Jenis: WPARAM

Parameter ini tidak digunakan.

lParam [in]

Jenis: LPARAM

Penunjuk ke struktur pesan MSG .

Mengembalikan

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, dan prosedur kait tidak memproses pesan, sangat disarankan agar Anda memanggil CallNextHookEx dan mengembalikan nilai yang dikembalikannya; jika tidak, aplikasi lain yang telah menginstal kait WH_SYSMSGFILTER tidak akan menerima pemberitahuan kait dan mungkin bertingkah salah sebagai hasilnya.

Jika prosedur kait memproses pesan, itu dapat mengembalikan nilai bukan nol untuk mencegah sistem meneruskan pesan ke prosedur jendela target.

Keterangan

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