Fungsi CallMsgFilterA (winuser.h)

Artikel
07/01/2023

Meneruskan pesan dan kode kait yang ditentukan ke prosedur kait yang terkait dengan kait WH_SYSMSGFILTER dan WH_MSGFILTER . Prosedur hook WH_SYSMSGFILTER atau WH_MSGFILTER adalah fungsi panggilan balik yang ditentukan aplikasi yang memeriksa dan, secara opsional, memodifikasi pesan untuk kotak dialog, kotak pesan, menu, atau bilah gulir.

Sintaks

BOOL CallMsgFilterA(
  [in] LPMSG lpMsg,
  [in] int   nCode
);

Parameter

[in] lpMsg

Jenis: LPMSG

Penunjuk ke struktur MSG yang berisi pesan yang akan diteruskan ke prosedur kait.

[in] nCode

Jenis: int

Kode yang ditentukan aplikasi yang digunakan oleh prosedur kait untuk menentukan cara memproses pesan. Kode tidak boleh memiliki nilai yang sama dengan kode kait yang ditentukan sistem (MSGF_ dan HC_) yang terkait dengan kait WH_SYSMSGFILTER dan WH_MSGFILTER .

Nilai kembali

Jenis: BOOL

Jika aplikasi harus memproses pesan lebih lanjut, nilai yang dikembalikan adalah nol.

Jika aplikasi tidak boleh memproses pesan lebih lanjut, nilai yang dikembalikan bukan nol.

Keterangan

Sistem memanggil CallMsgFilter untuk memungkinkan aplikasi memeriksa dan mengontrol alur pesan selama pemrosesan internal kotak dialog, kotak pesan, menu, dan bilah gulir, atau ketika pengguna mengaktifkan jendela yang berbeda dengan menekan kombinasi tombol ALT+TAB.

Instal prosedur hook ini dengan menggunakan fungsi SetWindowsHookEx .

Contoh

Misalnya, lihat WH_MSGFILTER dan WH_SYSMSGFILTER Hooks.

Catatan

Header winuser.h mendefinisikan CallMsgFilter sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-message-l1-1-0 (diperkenalkan di Windows 8)