Fungsi CallMsgFilterA (winuser.h)
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) |
Lihat juga
Konseptual
Referensi