PostThreadMessageA 函数（winuser.h）

项目
11/20/2024

将消息发布到指定线程的消息队列。它返回时不等待线程处理消息。

语法

BOOL PostThreadMessageA(
  [in] DWORD  idThread,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

参数

[in] idThread

类型：DWORD

要向其发布消息的线程的标识符。

如果指定的线程没有消息队列，该函数将失败。当线程首次调用某个用户或 GDI 函数时，系统会创建线程的消息队列。有关详细信息，请参阅“备注”部分。

消息发布受 UIPI 的约束。进程的线程只能将消息发布到较低或等于完整性级别的线程的已发布消息队列。

此线程必须具有 SE_TCB_NAME 特权，才能将消息发布到属于具有相同本地唯一标识符（LUID）但位于其他桌面中的进程的线程。否则，函数将失败并返回 ERROR_INVALID_THREAD_ID。

此线程必须与调用线程属于同一桌面，或者属于具有相同 LUID 的进程。否则，函数将失败并返回 ERROR_INVALID_THREAD_ID。

[in] Msg

类型：UINT

要发布的消息的类型。

[in] wParam

类型：WPARAM

其他特定于消息的信息。

[in] lParam

类型：LPARAM

其他特定于消息的信息。

返回值

类型：BOOL

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

如果函数失败，则返回值为零。若要获取扩展的错误信息，请调用 GetLastError。 GetLastError 返回 ERROR_INVALID_THREAD_ID，如果 idThread 不是有效的线程标识符，或者由 idThread 指定的线程没有消息队列。 GetLastError 在达到消息限制时返回 ERROR_NOT_ENOUGH_QUOTA。

言论

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

消息发布到的线程必须已创建消息队列，否则调用 PostThreadMessage 失败。使用以下方法来处理这种情况。

创建事件对象，然后创建线程。
使用 WaitForSingleObject 函数等待事件在调用 PostThreadMessage之前将事件设置为信号状态。
在消息将发布到的线程中，调用 PeekMessage，如下所示，强制系统创建消息队列。
PeekMessage(&msg, NULL, WM_USER, WM_USER, PM_NOREMOVE)
设置事件，指示线程已准备好接收已发布的消息。

消息发布到的线程通过调用 GetMessage 或 PeekMessage 函数来检索消息。返回 MSG 结构的 hwnd 成员 NULL。

PostThreadMessage 发布的消息与窗口无关。作为一般规则，与窗口不关联的消息不能由 DispatchMessage 函数调度。因此，如果收件人线程处于模式循环中（由 MessageBox 或 DialogBox使用），则邮件将丢失。若要在模式循环中截获线程消息，请使用特定于线程的挂钩。

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

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

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Windows
                  USERPostMessageLimit

可接受的最小值为 4000。

注意

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