PostMessageA 函数（winuser.h）

项目
11/20/2024

将消息置于消息队列中，该消息与创建指定窗口的线程相关联，并返回，而无需等待线程处理消息。

若要在与线程关联的消息队列中发布消息，请使用 PostThreadMessage 函数。

语法

BOOL PostMessageA(
  [in, optional] HWND   hWnd,
  [in]           UINT   Msg,
  [in]           WPARAM wParam,
  [in]           LPARAM lParam
);

参数

[in, optional] hWnd

类型：HWND

窗口过程的句柄是接收消息。以下值具有特殊含义。

价值	意义
HWND_BROADCAST （（HWND）0xffff）	该消息将发布到系统中的所有顶级窗口，包括已禁用或不可见的未所有者窗口、重叠的窗口和弹出窗口。消息不会发布到子窗口。
零	该函数的行为类似于调用 PostThreadMessage，dwThreadId 参数设置为当前线程的标识符。

从 Windows Vista 开始，消息发布受 UIPI 的约束。进程的线程只能将消息发布到较小或等于完整性级别的进程中的线程的消息队列。

[in] Msg

类型：UINT

要发布的消息。

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

[in] wParam

类型：WPARAM

其他特定于消息的信息。

[in] lParam

类型：LPARAM

其他特定于消息的信息。

返回值

类型：BOOL

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

如果函数失败，则返回值为零。若要获取扩展的错误信息，请调用 GetLastError。

言论

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

通过调用 getMessage 或 PeekMessage 函数来检索消息队列中的消息。

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

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

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

请勿使用 PostMessage发布 WM_QUIT 消息;使用 PostQuitMessage 函数。

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

消息队列最多可以包含 10,000 条消息。此限制应足够大。如果应用程序超出限制，则应重新设计它以避免消耗这么多的系统资源。若要调整此限制，请修改以下注册表项。

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Windows
                  USERPostMessageLimit

如果函数失败，请调用 GetLastError 以获取扩展的错误信息。 GetLastError 在达到限制时返回 ERROR_NOT_ENOUGH_QUOTA。

可接受的最小值为 4000。

例子

以下示例演示如何使用 PostMessage 函数发布专用窗口消息。假设你定义了名为 WM_COMPLETE的专用窗口消息：

#define        WM_COMPLETE     (WM_USER + 0)

可以将消息发布到与创建指定窗口的线程关联的消息队列，如下所示：

 WaitForSingleObject (pparams->hEvent, INFINITE) ;
 lTime = GetCurrentTime () ;
 PostMessage (pparams->hwnd, WM_COMPLETE, 0, lTime);

有关更多示例，请参阅启动数据链接。

注意

winuser.h 标头将 PostMessage 定义为一个别名，该别名根据 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 中引入）