Win10环境下Shell不调用IContextMenu::QueryContextMenu问题求助

最高概率诱因：QueryInterface实现错误 #

Explorer在IShellExtInit::Initialize调用返回S_OK后，会主动调用QueryInterface查询IID_IContextMenu接口，如果你的QueryInterface实现没有正确响应这个接口查询，就会直接跳过后续QueryContextMenu的调用。
请检查你的QueryInterface代码，确保包含IContextMenu的匹配分支，示例正确实现如下：

HRESULT __stdcall ValidatorContextMenuHandler::QueryInterface(REFIID riid, void** ppvObject)
{
    if (ppvObject == nullptr) return E_POINTER;
    
    if (IsEqualIID(riid, IID_IUnknown) || IsEqualIID(riid, IID_IShellExtInit)) {
        *ppvObject = static_cast<IShellExtInit*>(this);
    } else if (IsEqualIID(riid, IID_IContextMenu)) {
        *ppvObject = static_cast<IContextMenu*>(this);
    } else {
        *ppvObject = nullptr;
        return E_NOINTERFACE;
    }
    
    AddRef();
    return S_OK;
}

其他排查点 #

• 检查方法签名一致性：头文件中QueryContextMenu使用STDMETHODIMP修饰，而同一接口的GetCommandString使用IFACEMETHODIMP，建议统一修改为IFACEMETHODIMP，避免宏展开后调用约定不匹配的问题。
• 检查注册表配置：
  • 确认你的扩展CLSID注册在对应文件类型的ContextMenuHandlers节点下（全局文件对应HKEY_CLASSES_ROOT\*\shellex\ContextMenuHandlers，目录对应HKEY_CLASSES_ROOT\Directory\shellex\ContextMenuHandlers）
  • 确认CLSID对应InprocServer32节点下的ThreadingModel值设置为Apartment，这是Shell扩展强制要求的线程模型
• 检查位版本匹配：64位系统下默认Explorer是64位进程，必须注册64位编译的DLL才能正常工作，32位DLL只会被32位程序的文件对话框加载。

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