通过

BroadcastSystemMessageW 函数 （winuser.h）

  • 项目

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

若要在定义请求时接收其他信息，请使用 BroadcastSystemMessageEx 函数。

语法

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

参数

[in] flags

类型：DWORD

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

价值 意义
BSF_ALLOWSFW
0x00000080
 使收件人能够在处理邮件时设置前台窗口。
BSF_FLUSHDISK
0x00000004
 在每个收件人处理邮件后刷新磁盘。
BSF_FORCEIFHUNG
0x00000020
 继续广播消息，即使超时期限过或收件人之一未响应。
BSF_IGNORECURRENTTASK
0x00000002
 不会将消息发送到属于当前任务的窗口。 这可以防止应用程序收到自己的消息。
BSF_NOHANG
0x00000008
 强制非响应应用程序超时。如果其中一个收件人超时，请不要继续广播消息。
BSF_NOTIMEOUTIFNOTHUNG
0x00000040
 等待对邮件的响应，只要收件人没有响应。 不超时。
BSF_POSTMESSAGE
0x00000010
 发布消息。 请勿与 BSF_QUERY结合使用。
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

其他特定于消息的信息。

返回值

类型：长

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

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

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

言论

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

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

例子

有关示例，请参阅 终止进程。

注意

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

要求

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

另请参阅

BroadcastSystemMessageEx

概念

消息和消息队列

参考

SendNotifyMessage