Share via

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

要发送的消息。

有关系统提供的消息的列表，请参阅 系统定义的消息。

[in] wParam

类型：WPARAM

其他的消息特定信息。

[in] lParam

类型：LPARAM

其他的消息特定信息。

[out, optional] pbsmInfo

类型： PBSMINFO

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

返回值

类型： long

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

如果函数无法广播消息，则返回值为 –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 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

另请参阅

BSMINFO

BroadcastSystemMessage

概念性

消息和消息队列

引用

SendNotifyMessage