PostThreadMessageW 関数 (winuser.h)

  • [アーティクル]

指定したスレッドのメッセージ キューにメッセージを投稿します。 スレッドがメッセージを処理するのを待たずに が返されます。

構文

BOOL PostThreadMessageW(
  [in] DWORD  idThread,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

パラメーター

[in] idThread

型: DWORD

メッセージの投稿先となるスレッドの識別子。

指定したスレッドにメッセージ キューがない場合、関数は失敗します。 システムは、スレッドが User 関数または GDI 関数の 1 つを最初に呼び出すときに、スレッドのメッセージ キューを作成します。 詳細については、「解説」を参照してください。

メッセージの投稿は UIPI の対象となります。 プロセスのスレッドは、整合性レベルが低いか等しいプロセス内のスレッドのポストされたメッセージ キューにのみメッセージを投稿できます。

このスレッドには、同じローカル一意識別子 (LUID) を持つプロセスに属しているが、別のデスクトップにあるスレッドにメッセージを投稿するには、 SE_TCB_NAME 特権が必要です。 それ以外の場合、関数は失敗し、 ERROR_INVALID_THREAD_IDを返します。

このスレッドは、呼び出し元のスレッドと同じデスクトップに属しているか、同じ LUID を持つプロセスに属している必要があります。 それ以外の場合、関数は失敗し、 ERROR_INVALID_THREAD_IDを返します。

[in] Msg

型: UINT

投稿するメッセージの種類。

[in] wParam

種類: WPARAM

追加のメッセージ固有情報。

[in] lParam

種類: LPARAM

追加のメッセージ固有情報。

戻り値

種類: BOOL

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

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 idThread が有効なスレッド識別子ではない場合、または idThread で指定されたスレッドにメッセージ キューがない場合、GetLastError はERROR_INVALID_THREAD_IDを返します。 GetLastError は 、メッセージ の制限に 達したときにERROR_NOT_ENOUGH_QUOTAを返します。

注釈

メッセージが UIPI によってブロックされると、 GetLastError で取得された最後のエラーは 5 (アクセス拒否) に設定されます。

メッセージが投稿されるスレッドでメッセージ キューが作成されている必要があります。そうしないと、 PostThreadMessage の呼び出しが失敗します。 この状況を処理するには、次の方法を使用します。

  • イベント オブジェクトを作成し、スレッドを作成します。
  • イベントがシグナル状態に設定されるまで待機してから PostThreadMessage を呼び出すには、WaitForSingleObject 関数を使用します。
  • メッセージが投稿されるスレッドで、ここに示すように PeekMessage を呼び出して、システムにメッセージ キューの作成を強制します。

    PeekMessage(&msg, NULL, WM_USER, WM_USER, PM_NOREMOVE)

  • イベントを設定して、スレッドが投稿されたメッセージを受信する準備ができていることを示します。
メッセージが投稿されるスレッドは、 GetMessage または PeekMessage 関数を呼び出してメッセージを取得します。 返される MSG 構造体の hwnd メンバーは NULL です。

PostThreadMessage によって投稿されたメッセージは、ウィンドウに関連付けされません。 一般に、ウィンドウに関連付けられていないメッセージは DispatchMessage 関数によってディスパッチできません。 したがって、受信者のスレッドがモーダル ループ内にある場合 ( MessageBox または DialogBox で使用される場合)、メッセージは失われます。 モーダル ループ中にスレッド メッセージをインターセプトするには、スレッド固有のフックを使用します。

システムは、システム メッセージ (0 ~ (WM_USER-1) の範囲) に対してのみマーシャリングを実行します。 他のメッセージ (これらの >= WM_USER) を別のプロセスに送信するには、カスタム マーシャリングを実行する必要があります。

メッセージ キューあたり 10,000 件の投稿メッセージの制限があります。 この制限は十分に大きくする必要があります。 アプリケーションが制限を超えた場合は、大量のシステム リソースを消費しないように再設計する必要があります。 この制限を調整するには、次のレジストリ キーを変更します。

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Windows
                  USERPostMessageLimit

許容される最小値は 4000 です。

注意

winuser.h ヘッダーは、PostThreadMessage をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

概念

GetCurrentThreadId

GetMessage

GetWindowThreadProcessId

Msg

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

その他のリソース

PeekMessage

PostMessage

リファレンス

Sleep

WaitForSingleObject