SendNotifyMessageW 函数 (winuser.h)
将指定的消息发送到一个或多个窗口。 如果窗口是由调用线程创建的, 则 SendNotifyMessage 将调用窗口的窗口过程,并且直到窗口过程处理完消息后才会返回。 如果窗口是由其他线程创建的, 则 SendNotifyMessage 会将消息传递到窗口过程并立即返回;它不会等待窗口过程完成消息处理。
语法
BOOL SendNotifyMessageW(
[in] HWND hWnd,
[in] UINT Msg,
[in] WPARAM wParam,
[in] LPARAM lParam
);
参数
[in] hWnd
类型:HWND
窗口的句柄,其窗口过程将接收消息。 如果此参数 HWND_BROADCAST ( (HWND) 0xffff) ,则消息将发送到系统中的所有顶级窗口,包括禁用或不可见的无所有者窗口、重叠窗口和弹出窗口;但消息不会发送到子窗口。
[in] Msg
类型: UINT
要发送的消息。
有关系统提供的消息的列表,请参阅 系统定义的消息。
[in] wParam
类型:WPARAM
其他的消息特定信息。
[in] lParam
类型:LPARAM
其他的消息特定信息。
返回值
类型: BOOL
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
如果将以下范围内的消息 WM_USER 发送到异步消息函数 (PostMessage、 SendNotifyMessage 和 SendMessageCallback) ,则其消息参数不能包含指针。 否则,操作会失败。 函数将在接收线程有机会处理消息之前返回,发送方将在使用之前释放内存。
需要使用 HWND_BROADCAST 进行通信的应用程序应使用 RegisterWindowMessage 函数获取应用程序间通信的唯一消息。
系统仅对系统消息执行封送处理, (范围为 0 到 (WM_USER-1) ) 。 若要将其他消息 (那些 >= WM_USER) 发送到另一个进程,必须执行自定义封送处理。
注意
winuser.h 标头将 SendNotifyMessage 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
API 集 | Windows 10版本 10.0.14393 中引入的 ext-ms-win-ntuser-message-l1-1-3 () |
请参阅
概念性
引用