次の方法で共有

SendMessageW 関数 (winuser.h)

  • [アーティクル]

指定したメッセージをウィンドウまたはウィンドウに送信します。 SendMessage 関数は、指定したウィンドウのウィンドウ プロシージャを呼び出し、ウィンドウ プロシージャがメッセージを処理するまで戻りません。

メッセージを送信してすぐに返すには、SendMessageCallback を使用するか、SendNotifyMessage 関数 します。 スレッドのメッセージ キューにメッセージを投稿してすぐに戻すには、PostMessage を使用するか、PostThreadMessage 関数 します。

構文

LRESULT SendMessageW(
  [in] HWND   hWnd,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

パラメーター

[in] hWnd

型: HWND

ウィンドウ プロシージャがメッセージを受信するウィンドウへのハンドル。 このパラメーターが HWND_BROADCAST ((HWND)0xffff) の場合、メッセージは、無効または非表示の未所有ウィンドウ、重複ウィンドウ、ポップアップ ウィンドウなど、システム内のすべての最上位ウィンドウに送信されます。ただし、メッセージは子ウィンドウに送信されません。

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

[in] Msg

型: UINT

送信するメッセージ。

システム提供のメッセージの一覧については、「System-Defined メッセージ」を参照してください。

[in] wParam

型: WPARAM

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

[in] lParam

型: LPARAM

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

戻り値

型: LRESULT

戻り値は、メッセージ処理の結果を指定します。送信されたメッセージによって異なります。

備考

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

HWND_BROADCAST を使用して通信する必要があるアプリケーションでは、RegisterWindowMessage 関数を使用して、アプリケーション間通信用の一意のメッセージを取得する必要があります。

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

指定されたウィンドウが呼び出し元のスレッドによって作成された場合、ウィンドウ・プロシージャーはサブルーチンとして直ちに呼び出されます。 指定したウィンドウが別のスレッドによって作成された場合、システムはそのスレッドに切り替え、適切なウィンドウ プロシージャを呼び出します。 スレッド間で送信されたメッセージは、受信スレッドがメッセージ取得コードを実行する場合にのみ処理されます。 送信側スレッドは、受信側のスレッドがメッセージを処理するまでブロックされます。 ただし、送信スレッドは、メッセージが処理されるのを待っている間に、キューに登録されていない受信メッセージを処理します。 これを回避するには、SMTO_BLOCK設定 SendMessageTimeout を使用します。 キューに入れされていないメッセージの詳細については、「非キュー メッセージ」を参照してください。

アクセシビリティ アプリケーションでは、SendMessage を使用して、WM_APPCOMMAND メッセージをシェルに送信してアプリケーションを起動できます。 この機能は、他の種類のアプリケーションで動作するとは限りません。

例

例については、「キーボード入力の表示 」を参照してください。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll
API セットの ext-ms-win-ntuser-message-l1-1-0 (Windows 8 で導入)

関連項目

概念

InSendMessage を する

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

PostMessage を する

PostThreadMessage を する

リファレンス

RegisterWindowMessage の

SendDlgItemMessage の

SendMessageCallback の

SendMessageTimeout の

SendNotifyMessage を する