Fungsi WaitMessage (winuser.h)

  • Artikel

Menghasilkan kontrol ke utas lain ketika utas tidak memiliki pesan lain dalam antrean pesannya. Fungsi WaitMessage menangguhkan utas dan tidak kembali hingga pesan baru ditempatkan dalam antrean pesan utas.

Sintaks

BOOL WaitMessage();

Mengembalikan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Perhatikan bahwa WaitMessage tidak mengembalikan jika ada input yang belum dibaca dalam antrean pesan setelah utas memanggil fungsi untuk memeriksa antrean. Ini karena fungsi seperti PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects, dan MsgWaitForMultipleObjectsEx memeriksa antrean lalu mengubah informasi status untuk antrean sehingga input tidak lagi dianggap baru. Panggilan berikutnya ke WaitMessage tidak akan kembali sampai input baru dari jenis yang ditentukan tiba. Input belum dibaca yang ada (diterima sebelum terakhir kali utas memeriksa antrean) diabaikan.

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-window-l1-1-4 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

Konseptual

GetMessage

Pesan dan Antrean Pesan

PeekMessage

Referensi