sendMessageCallbackA 函数 (winuser.h)

项目
08/28/2023

将指定的消息发送到一个或多个窗口。它调用指定窗口的窗口过程，如果窗口属于另一个线程，则立即返回。窗口过程处理消息后，系统会调用指定的回调函数，并将消息处理的结果和应用程序定义的值传递给回调函数。

语法

BOOL SendMessageCallbackA(
  [in] HWND          hWnd,
  [in] UINT          Msg,
  [in] WPARAM        wParam,
  [in] LPARAM        lParam,
  [in] SENDASYNCPROC lpResultCallBack,
  [in] ULONG_PTR     dwData
);

参数

[in] hWnd

类型：HWND

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

[in] Msg

类型： UINT

要发送的消息。

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

[in] wParam

类型：WPARAM

其他的消息特定信息。

[in] lParam

类型：LPARAM

其他的消息特定信息。

[in] lpResultCallBack

类型： SENDASYNCPROC

指向系统在窗口过程处理消息后调用的回调函数的指针。有关详细信息，请参阅 SendAsyncProc。

如果 hWndHWND_BROADCAST ( (HWND) 0xffff) ，系统会为每个顶级窗口调用一次 SendAsyncProc 回调函数。

[in] dwData

类型： ULONG_PTR

要发送到 lpCallBack 参数指向的回调函数的应用程序定义值。

返回值

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

如果目标窗口与调用方属于同一线程，则以同步方式调用窗口过程，并在窗口过程返回后立即调用回调函数。如果目标窗口属于与调用方不同的线程，则仅当调用 SendMessageCallback 的线程也调用 GetMessage、 PeekMessage 或 WaitMessage 时，才会调用回调函数。

如果将以下范围内的消息 WM_USER 发送到异步消息函数 (PostMessage、 SendNotifyMessage 和 SendMessageCallback) ，则其消息参数不能包含指针。否则，操作会失败。函数将在接收线程有机会处理消息之前返回，发送方将在使用之前释放内存。

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

系统仅对系统消息执行封送处理， (范围为 0 到 (WM_USER-1) ) 。若要将其他消息 (那些 >= WM_USER) 发送到另一个进程，必须执行自定义封送处理。

注意

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

要求

要求	值
最低受支持的客户端	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 (