如何可靠获取更新剪贴板的进程PID？API调用报错排查

为什么会出现ERROR_INVALID_WINDOW_HANDLE？ #

1. GetClipboardOwner返回的不一定是窗口句柄
   Windows剪贴板的所有者不一定是窗口——控制台程序、服务进程，或者有些程序调用SetClipboardData时没指定窗口所有者，这时候GetClipboardOwner返回的句柄根本不是合法的窗口句柄，直接传给GetWindowThreadProcessId肯定报错。

2. 缺少句柄有效性检查
   你代码里直接把GetClipboardOwner的返回值传给GetWindowThreadProcessId，完全没判断这个句柄是不是NULL、是不是有效窗口，碰到无效句柄自然触发1400错误。

3. API调用顺序的潜在注意点
   你先获取owner再打开剪贴板的顺序是对的，但OpenClipboard(hwnd)成功后，当前窗口会临时成为剪贴板所有者——不过这不是你这次报错的直接原因，只是后续逻辑需要留意这点。

修复代码的具体步骤 #

第一步：增加句柄有效性校验 #

先判断owner是不是有效窗口，再尝试获取PID：

var msg C.MSG
for C.GetMessageW(&msg, hwnd, 0, 0) != 0 {
    if msg.message == C.WM_CLIPBOARDUPDATE {
        owner := C.GetClipboardOwner()
        var pid C.DWORD = 0

        // 先检查句柄是否存在且为有效窗口
        if owner != C.HWND(C.NULL) && C.IsWindow(owner) != 0 {
            // 调用GetWindowThreadProcessId，同时检查返回值（返回0表示调用失败）
            if C.GetWindowThreadProcessId(owner, &pid) == 0 {
                // 可添加错误处理逻辑，比如通过C.GetLastError()获取具体错误码
            }
        } else {
            // 处理非窗口所有者的情况，比如给pid设默认值或记录日志
        }

        // 后续打开剪贴板、获取内容的逻辑保持不变
        if C.OpenClipboard(hwnd) == 0 {
            // ...
            continue
        }

        hdata := C.GetClipboardData(C.CF_UNICODETEXT)
        if hdata == C.HANDLE(C.NULL) {
            // ...
            C.CloseClipboard()
            continue
        }

        wstr := C.LPWSTR(C.GlobalLock(hdata))
        content := wstrToGoStr(wstr)
        C.GlobalUnlock(hdata)
        C.CloseClipboard()

        handler(int(pid), content)
    }
    C.TranslateMessage(&msg)
    C.DispatchMessage(&msg)
}

第二步：应对非窗口所有者的场景 #

如果碰到剪贴板所有者不是窗口的情况，GetClipboardOwner拿不到有效PID，可尝试这些替代方案：

• 使用GetOpenClipboardWindow获取当前打开剪贴板的窗口句柄（仅当有进程正打开剪贴板时有效）
• 借助GetClipboardSequenceNumber追踪剪贴板变化，但这种方法可靠性较低
• 若需要精准追踪所有进程，可使用系统钩子（如SetWindowsHookEx），但实现复杂度较高

额外提醒 #

• 所有Windows API调用都要检查返回值，比如GetWindowThreadProcessId返回0表示调用失败，此时可通过GetLastError获取具体错误原因
• 剪贴板所有者可能在WM_CLIPBOARDUPDATE消息发送后立即销毁，就算IsWindow返回true，后续操作仍可能出错，必须做好容错处理

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