PostThreadMessage

小甲鱼

函数功能：

PostThreadMessage 函数将一个消息放入指定线程的消息队列中，并且不等待线程处理消息就立即返回。


API 函数原型：

BOOL WINAPI PostThreadMessage(
  _In_ DWORD  idThread,
  _In_ UINT   Msg,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

参数解析：

参数	含义
idThread	1. 指定接收消息的线程的标识符 2. 如果指定的线程没有消息队列，则函数调用失败。（当线程第一次调用一个 Win32 USER 或 GDI 函数时，系统将创建线程的消息队列。更多细节请参考下方备注） 3. 消息发送需服从 UIPI（User Interface Privilege Isolation，用户界面特权隔离）技术，消息只能发送到较小或同等级别的进程中的线程的消息队列 4. 如果要往不同桌面的线程（所属进程拥有相同的 LUID）中发送消息，该线程需要拥有 SE_TCB_NAME 权限才行。否则，函数调用失败并返回 ERROR_INVALID_THREAD_ID 5. 该线程必须与调用者处于同一桌面，或所属进程拥有相同的 LUID。否则，函数调用失败并返回 ERROR_INVALID_THREAD_ID
Msg	1. 指定将被发送的消息 2. 请参考：Windows 常用消息及含义
wParam	消息的附加信息
lParam	消息的附加信息

返回值：

1. 如果该函数调用成功，返回值是非 0；

2. 如果该函数调用失败，返回值是 0（如果调用 GetLastError 函数的返回值是 ERROR_INVALID_THREAD_ID，说明 idThread 参数不是一个合法的线程标识符，或者 idThread 参数指定的线程不具有消息队列；如果调用 GetLastError 函数的返回值是 ERROR_NOT_ENOUGH_QUOTA，则说明投递消息超出限制）。


备注：

1. 当消息被 UIPI 所阻断，调用 GetLastError 函数可以获得错误代码是 5（拒绝访问）。

2. 接收消息的线程必须创建一个消息队列，否则 PostThreadMessage 函数调用失败。

遇到这个问题，请使用下边方法解决：

• 创建一个事件对象，然后创建线程。
• 在调用 PostThreadMessage 函数前，使用 WaitForSingleObject 函数等待事件被设置为有信号状态。
• 在发送消息的线程中，调用 PeekMessage 函数（PeekMessage(&msg, NULL, WM_USER, WM_USER, PM_NOREMOVE)）来强制系统创建消息队列。
• 设置事件，表示线程已准备好接收寄送的消息。
  

3. 从消息队列中获取消息，请使用 GetMessage 或 PeekMessage 函数。MSG 结构的 hwnd 成员应该是 NULL。

4. PostThreadMessage 发送的消息并不与窗口相关联。就一般规则而言，不与窗口相关联的消息不能通过 DispatchMessage 函数分派。因此，如果接收消息的线程在模式循环中（例如 MessageBox 或 DialogBox），消息将可能丢失。应该使用线程钩子在模式循环下拦截线程消息。

5. 系统只对系统级的消息（0 ~ WM_USER-1）进行封送处理。发送自定义消息（>= WM_USER）到另一个进程，你需要自己对消息进行封送处理。

6. 每个消息队列限制可以放入 10,000 个消息。这个限制应该是足够大的，如果你的应用程序超过限制，那么它应该重新设计以避免消耗太多的系统资源。不过修改下边注册表项，可以调整这个限制：

| HKEY_LOCAL_MACHINE
| -- SOFTWARE
| -- -- Microsoft
| -- -- -- Windows NT
| -- -- -- -- CurrentVersion
| -- -- -- -- -- Windows
| -- -- -- -- -- -- USERPostMessageLimit

注：可调节的最小值是 4000。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。