WaitMessage

WaitMessage是一種計算機函式，功能為執行緒的訊息佇列中無其它訊息時，該函式就將控制權交給另外的執行緒。

基本介紹

• 中文名：WaitMessage
• 函式原型：BOOL WaitMessage（VOID）
• 參數：無

函式功能

當一個執行緒的訊息佇列中無其它訊息時，該函式就將控制權交給另外的執行緒，同時將該執行緒掛起，直到一個新的訊息被放入執行緒的訊息佇列之中才返回。

函式原型

BOOL WaitMessage（VOID）

參數

該函式無參數.

返回值

如果函式調用成功，返回非零值；如果函式調用失敗，返回值是零。若想獲得更多的錯誤信息，請調用GetLastError函式。

備註

在執行緒調用一個函式來檢查佇列後，如果有未經閱讀的輸入在訊息佇列里，WaitMessage不返回。這是因為PeekMessage，GetMessage，GetQueueStatus：WaitMessage，MsgWaitForMultipleObjects，MsgWaitForMulitpleObjectEx等函式檢查佇列後，改變佇列的狀態信息這樣輸入不再被認為是新的。如果連續調用WaitMessage，將等到指定類型的新輸入到達後才返回。已存在的未讀過的輸入（在上次執行緒檢查佇列之前接收的）被忽略。

速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；頭檔案：winuser.h；輸入庫：user32.lib。