SendMessageW 函数（winuser.h）

项目
11/20/2024

将指定的消息发送到窗口或窗口。 SendMessage 函数调用指定窗口的窗口过程，在窗口过程处理消息之前不会返回。

若要立即发送消息并立即返回，请使用 SendMessageCallback 或 SendNotifyMessage 函数。若要将消息发布到线程的消息队列并立即返回，请使用 PostMessage 或 PostThreadMessage 函数。

语法

LRESULT SendMessageW(
  [in] HWND   hWnd,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

参数

[in] hWnd

类型：HWND

窗口过程的句柄将接收消息。如果此参数 HWND_BROADCAST（HWND）0xffff），则会将消息发送到系统中的所有顶级窗口，包括已禁用或不可见的未所有者窗口、重叠窗口和弹出窗口;但消息不会发送到子窗口。

消息发送受 UIPI 的约束。进程的线程只能将消息发送到进程较小或相等完整性级别的线程的消息队列。

[in] Msg

类型：UINT

要发送的消息。

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

[in] wParam

类型：WPARAM

其他特定于消息的信息。

[in] lParam

类型：LPARAM

其他特定于消息的信息。

返回值

类型：LRESULT

返回值指定消息处理的结果;这取决于发送的消息。

言论

当 UIPI 阻止消息时，使用 GetLastError检索到的最后一个错误设置为 5（访问被拒绝）。

需要使用 HWND_BROADCAST 进行通信的应用程序应使用 RegisterWindowMessage 函数来获取应用程序间通信的唯一消息。

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

如果指定的窗口是由调用线程创建的，则窗口过程将立即作为子例程调用。如果指定的窗口是由另一个线程创建的，则系统会切换到该线程并调用相应的窗口过程。仅当接收线程执行消息检索代码时，才会处理线程之间发送的消息。在接收线程处理消息之前，将阻止发送线程。但是，发送线程将在等待处理消息时处理传入的非排队消息。若要防止出现这种情况，请将 SendMessageTimeout 与SMTO_BLOCK集一起使用。有关非排队消息的详细信息，请参阅非排队消息。

辅助功能应用程序可以使用 SendMessage 将 WM_APPCOMMAND 消息发送到 shell 以启动应用程序。不能保证此功能适用于其他类型的应用程序。

例子

有关示例，请参阅显示键盘输入。

注意

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

要求

要求	价值
最低支持的客户端	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 中引入）