WaitMessage 函式 (winuser.h)

  • 發行項

當執行緒在其訊息佇列中沒有其他訊息時，產生其他執行緒的控制。 WaitMessage函式會暫停執行緒，而且線上程訊息佇列中放置新訊息之前不會傳回。

Syntax

BOOL WaitMessage();

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

請注意，如果執行緒呼叫函式來檢查佇列之後，訊息佇列中沒有未讀取的輸入， WaitMessage 就不會傳回。 這是因為PeekMessage、GetMessage、GetQueueStatus、WaitMessage、MsgWaitForMultipleObjects和MsgWaitForMultipleObjectsEx等函式會檢查佇列，然後變更佇列的狀態資訊，讓輸入不再被視為新的。 後續對 WaitMessage 的呼叫將不會傳回，直到指定之型別的新輸入送達為止。 上次執行緒檢查佇列) 之前收到的現有未讀取輸入 (。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-window-l1-1-4 (于 Windows 10 10.0.14393 版)

另請參閱

概念

GetMessage

訊息和訊息佇列

PeekMessage

參考