postThreadMessageA 函数 (winuser.h)

项目
05/20/2023

将消息发布到指定线程的消息队列。它会返回，而无需等待线程处理消息。

语法

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

parameters

[in] idThread

类型：DWORD

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

如果指定的线程没有消息队列，则函数将失败。当线程首次调用 User 或 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。如果 idThread 不是有效的线程标识符，或者 idThread 指定的线程没有消息队列，则 GetLastError 返回ERROR_INVALID_THREAD_ID。 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 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-message-l1-1-0 (