Win32同线程WH_GETMESSAGE钩子无法捕获WM_LBUTTONDOWN消息的问题排查

注：安装钩子的参数写法本身符合线程局部钩子的要求——针对当前线程的WH_GETMESSAGE钩子无需挂载在动态链接库中，传NULL作为模块句柄、传入当前线程ID作为目标参数是完全正确的用法，不存在安装参数层面的错误。

• 参数类型强转完全不匹配WH_GETMESSAGE钩子的规范：WH_GETMESSAGE钩子传入的lParam是指向MSG结构体的指针，代码中错误强转为LPCWPSTRUCT，而WPSTRUCT是WH_CALLWNDPROC类钩子使用的结构体类型，二者仅前4个字段内存布局巧合对齐，属于未定义行为，极易读取到错误的字段值，导致消息类型匹配永远无法命中WM_LBUTTONDOWN。
• 验证逻辑无有效反馈：匹配到目标消息的分支中仅写入Sleep(0)，该操作没有任何可观测的输出，哪怕钩子真的命中分支，也无法被直观感知，很容易造成“未捕获消息”的误判。
• 前置触发条件未校验：WH_GETMESSAGE钩子仅在当前线程调用GetMessage/PeekMessage从消息队列取出消息时才会触发回调。如果安装钩子后未在当前线程运行标准消息循环，哪怕钩子安装成功，也永远不会进入GetMsgProc的处理逻辑。
• 冗余逻辑无实际作用：对nCode的switch分支判断是多余的，当nCode >= 0时，WH_GETMESSAGE钩子的nCode固定为HC_ACTION（值为0），不存在其他取值，这部分逻辑不影响运行但增加了不必要的复杂度。

• 修正类型转换：将原强转逻辑替换为：

  const MSG* pMsg = (const MSG*)lParam;
  

  直接读取pMsg->message匹配目标消息类型。
• 替换无效的验证代码：将分支内的Sleep(0)替换为有明确输出的逻辑，比如通过OutputDebugStringA输出捕获日志，或弹出提示框，直观确认钩子是否触发。
• 补全消息循环逻辑：安装钩子后在当前线程保持标准消息循环调用，保证WH_GETMESSAGE钩子能正常触发：

  MSG msg;
  while (GetMessage(&msg, NULL, 0, 0))
  {
      TranslateMessage(&msg);
      DispatchMessage(&msg);
  }
  

• 增加安装结果校验：钩子安装完成后判断返回的hhook是否为NULL，通过GetLastError排查安装失败的场景，避免钩子未正常挂载的问题。

内容的提问来源于stack exchange，提问作者Lucas