IContextMenu::QueryContextMenu调用返回异常菜单问题排查

问题1：缺失「Properties」菜单项 #

原因 #

管理员文件夹属于系统特殊文件夹，若未正确获取Shell对象或调用QueryContextMenu时参数错误，会导致Shell未加载完整的菜单扩展。常见情况包括：

• 未通过SHCreateItemFromParsingName获取目标路径对应的IShellItem，而是用其他方式创建上下文，导致菜单扩展加载不完整。
• 调用QueryContextMenu时设置了CMF_DEFAULTONLY标志，该标志会仅显示默认菜单项，过滤掉Properties这类选项。
• QueryContextMenu的返回值处理不当，菜单ID范围覆盖了系统菜单项ID。

解决方法 #

• 必须通过SHCreateItemFromParsingName将目标路径转换为IShellItem，再调用IShellItem::BindToHandler获取IContextMenu实例，确保基于正确的Shell对象构建菜单。
• 移除CMF_DEFAULTONLY标志，保留CMF_NORMAL或CMF_EXPLORE等常规标志，让Shell加载全部可用菜单项。
• 确保idCmdFirst和idCmdLast设置的自定义菜单ID范围不与系统菜单项冲突，调用后根据返回值确认实际添加的菜单项数量。

问题2：点击「Restore previous versions」触发错误（GetLastError=1223） #

错误码1223对应ERROR_CANCELLED，本质是命令调用上下文不合法或权限不足：

原因 #

• CMINVOKECOMMANDINFO/CMINVOKECOMMANDINFOEX的hwnd成员未设置有效窗口句柄，该菜单项需要父窗口显示卷影副本对话框，无有效句柄会导致调用取消。
• 进程权限不足，访问卷影副本需要SeBackupPrivilege和SeRestorePrivilege权限，普通进程可能无法获取。
• 命令ID传递错误，手动修改了QueryContextMenu返回的系统菜单项ID，导致调用无效命令。

解决方法 #

• 将CMINVOKECOMMANDINFO的hwnd设为当前程序的主窗口句柄，确保对话框能正常弹出。
• 以管理员身份运行程序，或在进程启动时启用SeBackupPrivilege和SeRestorePrivilege权限（通过AdjustTokenPrivileges实现）。
• 严格使用QueryContextMenu返回的ID范围调用InvokeCommand，可通过IContextMenu::GetCommandString验证命令的有效性。

问题3：路径指向文件时「Share」菜单无法工作 #

原因 #

Share菜单依赖Shell的共享扩展组件，若上下文初始化错误或标志设置不当，会导致扩展无法加载：

• 未针对文件类型正确获取IContextMenu，比如使用了文件夹的绑定句柄而非文件对应的BHID_SFUIObject。
• 调用QueryContextMenu时未设置CMF_EXPLORE标志，该标志告知Shell当前处于资源管理器上下文，会加载共享相关扩展。
• 文件所在卷不支持共享，或当前用户无修改文件共享设置的权限。

解决方法 #

• 获取文件的IContextMenu时，调用IShellItem::BindToHandler传入BHID_SFUIObject作为绑定ID，确保加载文件对应的菜单扩展。
• 在QueryContextMenu的uFlags参数中添加CMF_EXPLORE标志，触发Shell加载资源管理器风格的菜单扩展。
• 检查文件所在卷的共享设置，确保当前用户拥有修改共享权限的权限（需管理员或文件所有者权限）。

代码检查要点 #

• 确认SHCreateItemFromParsingName调用成功，返回的IShellItem指针有效（未返回E_FAIL等错误）。
• 检查QueryContextMenu的参数：hmenu为合法菜单句柄，indexMenu起始位置正确，idCmdFirst/idCmdLast未与系统菜单项ID重叠。
• 调用InvokeCommand时，CMINVOKECOMMANDINFO的lpVerb或iVerb参数正确，未手动篡改系统命令的标识。

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