通过

BroadcastSystemMessageExA 函数 （winuser.h）

  • 项目

向指定的收件人发送邮件。 接收者可以是应用程序、可安装驱动程序、网络驱动程序、系统级设备驱动程序或这些系统组件的任意组合。

此函数类似于 BroadcastSystemMessage，但此函数可以返回收件人的详细信息。

语法

long BroadcastSystemMessageExA(
  [in]                DWORD    flags,
  [in, out, optional] LPDWORD  lpInfo,
  [in]                UINT     Msg,
  [in]                WPARAM   wParam,
  [in]                LPARAM   lParam,
  [out, optional]     PBSMINFO pbsmInfo
);

参数

[in] flags

类型：DWORD

广播选项。 此参数可以是以下一个或多个值。

价值 意义
BSF_ALLOWSFW
0x00000080
 使收件人能够在处理邮件时设置前台窗口。
BSF_FLUSHDISK
0x00000004
 在每个收件人处理邮件后刷新磁盘。
BSF_FORCEIFHUNG
0x00000020
 继续广播消息，即使超时期限过或收件人之一未响应。
BSF_IGNORECURRENTTASK
0x00000002
 不会将消息发送到属于当前任务的窗口。 这可以防止应用程序收到自己的消息。
BSF_LUID
0x00000400
 如果设置了 BSF_LUID，则会将消息发送到与 BSMINFO 结构 luid 成员中指定的 LUID 相同的窗口。

Windows 2000：不支持 此标志。
BSF_NOHANG
0x00000008
 强制非响应应用程序超时。如果其中一个收件人超时，请不要继续广播消息。
BSF_NOTIMEOUTIFNOTHUNG
0x00000040
 等待对邮件的响应，只要收件人没有响应。 不超时。
BSF_POSTMESSAGE
0x00000010
 发布消息。 请勿与 BSF_QUERY结合使用。
BSF_RETURNHDESK
0x00000200
 如果访问被拒绝并且同时设置了此访问和 BSF_QUERY，BSMINFO 将同时返回桌面句柄和窗口句柄。 如果访问被拒绝，并且仅设置 BSF_QUERY，则只有 BSMINFO返回窗口句柄。

Windows 2000：不支持 此标志。
BSF_QUERY
0x00000001
 一次向一个收件人发送邮件，仅当当前收件人返回 TRUE 时，才会发送到后续收件人。
BSF_SENDNOTIFYMESSAGE
0x00000100
 使用 SendNotifyMessage 函数发送消息。 请勿与 BSF_QUERY结合使用。

[in, out, optional] lpInfo

类型：LPDWORD

指向包含和接收有关邮件收件人信息的变量的指针。

当函数返回时，此变量将接收这些值的组合，这些值标识哪些收件人实际接收了邮件。

如果此参数 NULL，则该函数将广播到所有组件。

此参数可以是以下一个或多个值。

价值 意义
BSM_ALLCOMPONENTS
0x00000000
 广播到所有系统组件。
BSM_ALLDESKTOPS
0x00000010
 广播到所有桌面。 需要 SE_TCB_NAME 特权。
BSM_APPLICATIONS
0x00000008
 广播到应用程序。

[in] Msg

类型：UINT

要发送的消息。

有关系统提供的消息列表，请参阅 System-Defined 消息。

[in] wParam

类型：WPARAM

其他特定于消息的信息。

[in] lParam

类型：LPARAM

其他特定于消息的信息。

[out, optional] pbsmInfo

类型：PBSMINFO

指向 BSMINFO 结构的指针，如果请求被拒绝，并且 dwFlags 设置为 BSF_QUERY，则包含其他信息的指针。

返回值

类型：长

如果函数成功，则返回值为正值。

如果函数无法广播消息，则返回值为 –1。

如果 dwFlags 参数 BSF_QUERY，并且至少有一个收件人 BROADCAST_QUERY_DENY 返回相应邮件，则返回值为零。 若要获取扩展的错误信息，请调用 GetLastError。

言论

如果未指定 BSF_QUERY，该函数会将指定的邮件发送到所有请求的收件人，忽略这些收件人返回的值。

如果调用方线程位于拒绝请求的窗口以外的桌面上，则调用方必须调用 SetThreadDesktop（hdesk） 来查询该窗口上的任何内容。 此外，调用方必须在返回的 hdesk 句柄上调用 CloseDesktop。

系统只对系统消息进行封送（范围为 0 到 （WM_USER-1） 中的消息）。 若要将其他消息（这些 >= WM_USER）发送到另一个进程，必须执行自定义封送。

注意

winuser.h 标头将 BroadcastSystemMessageEx 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 winuser.h （包括 Windows.h）
库 User32.lib
DLL User32.dll

另请参阅

BSMINFO

BroadcastSystemMessage

概念

消息和消息队列

参考

SendNotifyMessage