Fungsi DispatchMessageW (winuser.h)

Artikel
03/04/2024

Mengirimkan pesan ke prosedur jendela. Biasanya digunakan untuk mengirimkan pesan yang diambil oleh fungsi GetMessage .

Sintaks

LRESULT DispatchMessageW(
  [in] const MSG *lpMsg
);

Parameter

[in] lpMsg

Jenis: const MSG*

Penunjuk ke struktur yang berisi pesan.

Nilai kembali

Jenis: LRESULT

Nilai yang dikembalikan menentukan nilai yang dikembalikan oleh prosedur jendela. Meskipun maknanya tergantung pada pesan yang dikirim, nilai pengembalian umumnya diabaikan.

Keterangan

Struktur MSG harus berisi nilai pesan yang valid. Jika parameter lpmsg menunjuk ke pesan WM_TIMER dan parameter lParam dari pesan WM_TIMER bukan NULL, lParam menunjuk ke fungsi yang dipanggil alih-alih prosedur jendela.

Perhatikan bahwa aplikasi bertanggung jawab untuk mengambil dan mengirimkan pesan input ke kotak dialog. Sebagian besar aplikasi menggunakan perulangan pesan utama untuk ini. Namun, untuk mengizinkan pengguna berpindah ke dan memilih kontrol dengan menggunakan keyboard, aplikasi harus memanggil IsDialogMessage. Untuk informasi selengkapnya, lihat Antarmuka Keyboard Kotak Dialog.

Contoh

Misalnya, lihat Membuat Perulangan Pesan.

Catatan

Header winuser.h mendefinisikan DispatchMessage 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

Persyaratan	Nilai
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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-message-l1-1-0 (diperkenalkan dalam Windows 8)