Electron中调用TrackPopupMenuEx返回0无法弹出文件右键菜单排查

我正在基于Electron开发功能，点击窗口内按钮后需弹出指定文件的系统右键菜单，采用node-addon-api实现，相关代码如下：

C++ 代码 #

Napi::Boolean ContextMenu(const Napi::CallbackInfo &info)
{
    // CoInitialize
    CoInitialize(NULL);
    // 获取文件路径
    std::string filePath = info[1].ToString().Utf8Value();
    // 获取文件的 IShellItem 接口
    IShellItem* pItem;
    HRESULT hr = SHCreateItemFromParsingName(StringToLPCWSTR(UTF8ToGBK(filePath.c_str())), NULL, IID_PPV_ARGS(&pItem));
    if (FAILED(hr))
    {
        std::cout << "Failed to create shell item." << std::endl;
        return Napi::Boolean::New(info.Env(), false);
    }
    // 获取文件的 IContextMenu 接口
    IContextMenu* pContextMenu;
    hr = pItem->BindToHandler(NULL, BHID_SFUIObject, IID_PPV_ARGS(&pContextMenu));
    if (FAILED(hr))
    {
        std::cout << "Failed to get context menu." << std::endl;
        pItem->Release();
        return Napi::Boolean::New(info.Env(), false);
    }
    // 创建菜单
    HMENU hMenu = CreatePopupMenu();
    if (hMenu == NULL)
    {
        std::cout << "Failed to create menu." << std::endl;
        pContextMenu->Release();
        pItem->Release();
        return Napi::Boolean::New(info.Env(), false);
    }
    hr = pContextMenu->QueryContextMenu(hMenu, 0, 1, 0x7FFF, CMF_NORMAL);
    if (FAILED(hr))
    {
        std::cout << "Failed to query context menu." << std::endl;
        DestroyMenu(hMenu);
        pContextMenu->Release();
        pItem->Release();
        return Napi::Boolean::New(info.Env(), false);
    }
    // 显示菜单
    POINT pt;
    GetCursorPos(&pt);
    // 获取当前窗口句柄
    Napi::Buffer<void *> buffer = info[0].As<Napi::Buffer<void *>>();
    HWND hWnd = static_cast<HWND>(*reinterpret_cast<void **>(buffer.Data()));
    if (!IsWindow(hWnd)) {
        std::cout << "Invalid window handle" << std::endl;
        return Napi::Boolean::New(info.Env(), false);
    }
    int command = TrackPopupMenuEx(hMenu, TPM_RETURNCMD, pt.x, pt.y, hWnd, NULL);
    if (command == 0)
    {
        DWORD err = GetLastError();
        std::cout << "Failed to display menu. Error code: " << err << std::endl;
    }
    // 释放资源
    DestroyMenu(hMenu);
    pContextMenu->Release();
    pItem->Release();
    // CoUninitialize
    CoUninitialize();
    return Napi::Boolean::New(info.Env(), true);
}

Node.js 代码 #

global.api.ContextMenu(global.mainWindow.getNativeWindowHandle(), index.getAbsolutePath(item.path))

调用ContextMenu方法后，TrackPopupMenuEx始终返回0，无菜单弹出，但GetLastError返回0，此前右键菜单可正常弹出，请问该问题的原因是什么？

可能的原因 #

1. COM线程模型不匹配
   Shell相关的COM接口要求在**单线程单元(STA)**环境下运行，但CoInitialize(NULL)默认可能将线程初始化为多线程单元(MTA)。如果当前Node-Addon的回调线程是MTA，会导致Shell菜单接口无法正常工作，虽然不会直接返回错误，但菜单无法渲染弹出。

2. 路径编码转换错误
   UTF8ToGBK和StringToLPCWSTR的转换逻辑可能存在问题，导致传递给SHCreateItemFromParsingName的路径无效。此时IShellItem虽然创建成功，但后续无法获取有效的上下文菜单内容，最终TrackPopupMenuEx因无菜单项可显示而返回0。

3. 线程上下文不匹配
   Electron窗口的句柄属于主进程UI线程，而Node-Addon的回调可能在后台线程执行。TrackPopupMenuEx需要在窗口所属的UI线程调用，跨线程操作会导致菜单无法正确附着到窗口。

4. 菜单命令范围参数问题
   QueryContextMenu中指定的idCmdFirst=1和idCmdLast=0x7FFF范围可能与Shell扩展返回的命令ID冲突，导致实际没有菜单项被添加到菜单中。此时菜单是空的，TrackPopupMenuEx自然不会弹出任何内容。

建议的排查与修复步骤 #

• 明确指定STA线程初始化：将CoInitialize(NULL)替换为CoInitializeEx(NULL, COINIT_APARTMENTTHREADED)，强制线程以STA模式运行。
• 验证路径转换结果：在调用SHCreateItemFromParsingName前，输出转换后的宽字符串，确认路径与目标文件路径完全一致。
• 切换到UI线程执行菜单操作：通过Electron的ipcMain将菜单调用逻辑切换到主进程UI线程，或者在Addon中使用PostMessage将操作投递到窗口所属线程执行。
• 检查QueryContextMenu返回值：成功调用时，hr会返回MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NULL, count)，其中count是实际添加的菜单项数量。输出该值确认是否有菜单项被成功创建。

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