次の方法で共有


RegisterWindowMessageA 関数 (winuser.h)

システム全体で一意であることが保証される新しいウィンドウ メッセージを定義します。 メッセージ値は、メッセージを送信または投稿するときに使用できます。

構文

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

パラメーター

[in] lpString

型: LPCTSTR

登録するメッセージ。

戻り値

型: UINT

メッセージが正常に登録された場合、戻り値は0xFFFF 0xC000範囲内のメッセージ識別子です。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

RegisterWindowMessage 関数は、通常、2 つの連携するアプリケーション間で通信するためのメッセージを登録するために使用されます。

2 つの異なるアプリケーションが同じメッセージ文字列を登録すると、アプリケーションは同じメッセージ値を返します。 メッセージは、セッションが終了するまで登録されたままです。

複数のアプリケーション 同じメッセージを処理する必要がある場合にのみ、RegisterWindowMessage を使用します。 ウィンドウ クラス内でプライベート メッセージを送信する場合、アプリケーションは、0x7FFF WM_USER 範囲内の任意の整数を使用できます。 (この範囲のメッセージは、アプリケーションではなく、ウィンドウ クラスに対してプライベートです。たとえば、BUTTONEDITLISTBOXCOMBOBOX などの定義済みのコントロール クラスでは、この範囲の値を使用できます)。

例については、「テキストの検索」を参照してください。

手記

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

必要条件

要件 価値
サポートされる最小クライアント 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 で導入)

関連項目

概念

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

PostMessage を する

リファレンス

SendMessage を する