PostThreadMessageW 関数 (winuser.h)

[アーティクル]
05/20/2023

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

構文

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 で導入)