SendMessageCallbackA 函数（winuser.h）

项目
11/20/2024

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

语法

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

要发送的消息。

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

[in] wParam

类型：WPARAM

其他特定于消息的信息。

[in] lParam

类型：LPARAM

其他特定于消息的信息。

[in] lpResultCallBack

类型：SENDASYNCPROC

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

如果 hWnd 为 HWND_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 [仅限桌面应用]
目标平台	窗户
标头	winuser.h （包括 Windows.h）
库	User32.lib
DLL	User32.dll
API 集	ext-ms-win-ntuser-message-l1-1-0（在 Windows 8 中引入）