sendMessage 函数 (winuser.h)

项目
03/04/2024

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

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

语法

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

参数

[in] hWnd

类型：HWND

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

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

[in] Msg

类型： UINT

要发送的消息。

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

[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 以启动应用程序。此功能不保证适用于其他类型的应用程序。

示例

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

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-message-l1-1-0 (