PostMessageA 函数 (winuser.h)

项目
03/04/2024

Places (在与创建指定窗口的线程关联的消息队列中发布) 消息，并在不等待线程处理消息的情况下返回消息。

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

语法

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

参数

[in, optional] hWnd

类型：HWND

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

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

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

[in] Msg

类型： UINT

要发布的消息。

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

[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 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-message-l1-1-0 (