WaitMessage 関数 (winuser.h)

  • [アーティクル]

スレッドのメッセージ キューに他のメッセージがない場合に、他のスレッドに制御を提供します。 WaitMessage 関数はスレッドを中断し、スレッドのメッセージ キューに新しいメッセージが配置されるまで戻りません。

構文

BOOL WaitMessage();

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

スレッドがキューをチェックする関数を呼び出した後にメッセージ キューに未読の入力がある場合、WaitMessage は返されないことに注意してください。 これは、PeekMessage、GetMessage、GetQueueStatus、WaitMessage、MsgWaitForMultipleObjects、MsgWaitForMultipleObjectsEx などの関数がキューチェックし、入力が新しいと見なされないようにキューの状態情報を変更するためです。 WaitMessage への後続の呼び出しは、指定された型の新しい入力が到着するまで戻りません。 既存の未読入力 (スレッドがキューを最後にチェックした前に受信) は無視されます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-window-l1-1-4 (Windows 10 バージョン 10.0.14393 で導入)

関連項目

概念

GetMessage

メッセージとメッセージ キュー

PeekMessage

参照