BroadcastSystemMessageExW

指定された受信者にメッセージを送信する。(BroadcastSystemMessageExW)

BroadcastSystemMessageExW flags, lpInfo, Msg, wParam, lParam, pbsmInfo

flags : [int] 型: DWORD
lpInfo : [var] 型: LPDWORD メッセージの受信者に関する情報を保持し受け取る変数へのポインタ。
Msg : [int] 型: UINT 送信するメッセージ。システム提供メッセージのリストについては System-Defined Messages を参照。
wParam : [intptr] 型: WPARAM 追加のメッセージ固有情報。
lParam : [intptr] 型: LPARAM 追加のメッセージ固有情報。
pbsmInfo : [var] 型: PBSMINFO 要求が拒否され dwFlags が BSF_QUERY に設定されている場合の追加情報を格納する BSMINFO 構造体へのポインタ。

(プラグイン / モジュール : user32.dll)

解説

指定された受信者にメッセージを送信する。(BroadcastSystemMessageExW)

[戻り値]
型: long 関数が成功した場合、戻り値は正の値。メッセージをブロードキャストできない場合、戻り値は -1。dwFlags が
BSF_QUERY で、少なくとも 1 つの受信者が対応するメッセージに対して BROADCAST_QUERY_DENY
を返した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
BSF_QUERY
が指定されていない場合、関数は要求された全受信者に指定メッセージを送信し、それらが返す値は無視する。呼び出し元のスレッドが要求を拒否したウィンドウとは別のデスクトップにある場合、呼び出し元はそのウィンドウ上で何かを問い合わせるために
SetThreadDesktop(hdesk) を呼ぶ必要がある。また、返された hdesk ハンドルに対して CloseDesktop
を呼ぶ必要もある。システムはシステムメッセージ (0 から WM_USER-1 の範囲) のマーシャリングのみを行う。それ以外のメッセージ
(WM_USER 以上) を別プロセスに送るには独自のマーシャリングが必要である。
> [!NOTE] > winuser.h ヘッダは BroadcastSystemMessageEx
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づき自動的に ANSI/Unicode
版を選択する。エンコーディング非依存のエイリアスとそうでないコードを混在させると、コンパイル時または実行時のエラーにつながる不一致が生じる可能性がある。詳細は
Conventions for Function Prototypes を参照。

情報