无法为右键菜单注册IExecuteCommand，提示“类未注册”求助

问题背景 #

尝试为文本文件右键菜单注册IExecuteCommand接口，已编写64位COM DLL并通过.reg文件注册，但点击菜单项时弹出“类未注册”错误，系统为Windows 10 64位。

错误原因及修复步骤 #

1. 注册表文件路径错误 #

原.reg文件中HKEY_CLASSES_ROOT\\txtfile存在多余反斜杠，导致注册表项路径无效。

修复后的.reg文件：

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\CLSID\{0DF1F277-A2CD-4202-86AA-4C0BF1B8C5E4}]
@="Print Names to Debugger Extension"

[HKEY_CLASSES_ROOT\CLSID\{0DF1F277-A2CD-4202-86AA-4C0BF1B8C5E4}\InProcServer32]
@="C:\\Users\\Username\\OneDrive\\Desktop\\COM\\COMIExecuteCommand.dll"
"ThreadingModel"="Apartment"

[HKEY_CLASSES_ROOT\txtfile\shell\printnamestodebugger]
@="Print names to debugger"

[HKEY_CLASSES_ROOT\txtfile\shell\printnamestodebugger\command]
"DelegateExecute"="{0DF1F277-A2CD-4202-86AA-4C0BF1B8C5E4}"

注：建议通过DllRegisterServer自动注册，避免手动编写.reg的错误，下文会提供完善的注册代码。

2. COM代码中的核心错误 #

（1）全局引用计数未初始化

原代码中LONG g_cObjs;未初始化，导致DllCanUnloadNow逻辑判断错误。

修复代码：

// 初始化全局引用计数为0
LONG g_cObjs = 0;

（2）DllCanUnloadNow逻辑反转

原代码中返回值逻辑错误，当无对象引用时应返回S_OK允许卸载，否则返回S_FALSE。

修复代码：

STDAPI DllCanUnloadNow()
{
    // 当引用计数为0时，DLL可卸载
    return (g_cObjs == 0) ? S_OK : S_FALSE;
}

（3）类工厂引用计数硬编码

原CFactory的AddRef和Release硬编码返回固定值，不符合COM规范，导致对象生命周期管理错误。

修复代码：

class CFactory : public IClassFactory
{
public:
    CFactory() : m_cRef(1) {}
    // *** IUnknown ***
    STDMETHODIMP QueryInterface(REFIID riid, void** ppv);
    STDMETHODIMP_(ULONG) AddRef() { return InterlockedIncrement(&m_cRef); }
    STDMETHODIMP_(ULONG) Release() { 
        ULONG cRef = InterlockedDecrement(&m_cRef);
        // 全局实例不删除，返回当前计数
        return cRef;
    }
    // *** IClassFactory ***
    STDMETHODIMP CreateInstance(IUnknown* punkOuter, REFIID riid, void** ppv);
    STDMETHODIMP LockServer(BOOL fLock);
private:
    LONG m_cRef;
};

CFactory c_Factory;

（4）完善DllRegisterServer自动注册

手动编写.reg易出错，建议完善DllRegisterServer实现自动注册CLSID和右键菜单：

#include <shlwapi.h>
#pragma comment(lib, "shlwapi.lib")

HRESULT __stdcall DllRegisterServer()
{
    HRESULT hr;
    WCHAR szModulePath[MAX_PATH];
    if (!GetModuleFileNameW((HMODULE)&__ImageBase, szModulePath, MAX_PATH))
    {
        hr = HRESULT_FROM_WIN32(GetLastError());
        return hr;
    }

    // 注册CLSID
    WCHAR szCLSID[MAX_PATH];
    StringFromGUID2(CLSID_ShellExtension, szCLSID, MAX_PATH);
    WCHAR szCLSIDKey[MAX_PATH];
    wsprintfW(szCLSIDKey, L"CLSID\\%s", szCLSID);

    // 创建CLSID根项
    HKEY hKey;
    hr = HRESULT_FROM_WIN32(RegCreateKeyExW(HKEY_CLASSES_ROOT, szCLSIDKey, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hKey, NULL));
    if (FAILED(hr)) return hr;
    RegSetValueExW(hKey, NULL, 0, REG_SZ, (BYTE*)L"Print Names to Debugger Extension", (lstrlenW(L"Print Names to Debugger Extension") + 1) * sizeof(WCHAR));
    RegCloseKey(hKey);

    // 创建InProcServer32项
    WCHAR szInProcKey[MAX_PATH];
    wsprintfW(szInProcKey, L"%s\\InProcServer32", szCLSIDKey);
    hr = HRESULT_FROM_WIN32(RegCreateKeyExW(HKEY_CLASSES_ROOT, szInProcKey, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hKey, NULL));
    if (FAILED(hr)) return hr;
    RegSetValueExW(hKey, NULL, 0, REG_SZ, (BYTE*)szModulePath, (lstrlenW(szModulePath) + 1) * sizeof(WCHAR));
    RegSetValueExW(hKey, L"ThreadingModel", 0, REG_SZ, (BYTE*)L"Apartment", (lstrlenW(L"Apartment") + 1) * sizeof(WCHAR));
    RegCloseKey(hKey);

    // 注册txtfile右键菜单
    WCHAR szShellKey[MAX_PATH];
    wsprintfW(szShellKey, L"txtfile\\shell\\printnamestodebugger");
    hr = HRESULT_FROM_WIN32(RegCreateKeyExW(HKEY_CLASSES_ROOT, szShellKey, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hKey, NULL));
    if (FAILED(hr)) return hr;
    RegSetValueExW(hKey, NULL, 0, REG_SZ, (BYTE*)L"Print names to debugger", (lstrlenW(L"Print names to debugger") + 1) * sizeof(WCHAR));
    RegCloseKey(hKey);

    // 注册DelegateExecute
    WCHAR szCommandKey[MAX_PATH];
    wsprintfW(szCommandKey, L"%s\\command", szShellKey);
    hr = HRESULT_FROM_WIN32(RegCreateKeyExW(HKEY_CLASSES_ROOT, szCommandKey, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hKey, NULL));
    if (FAILED(hr)) return hr;
    RegSetValueExW(hKey, L"DelegateExecute", 0, REG_SZ, (BYTE*)szCLSID, (lstrlenW(szCLSID) + 1) * sizeof(WCHAR));
    RegCloseKey(hKey);

    return S_OK;
}

HRESULT __stdcall DllUnregisterServer()
{
    WCHAR szCLSID[MAX_PATH];
    StringFromGUID2(CLSID_ShellExtension, szCLSID, MAX_PATH);
    WCHAR szCLSIDKey[MAX_PATH];
    wsprintfW(szCLSIDKey, L"CLSID\\%s", szCLSID);
    // 删除CLSID项
    SHDeleteKeyW(HKEY_CLASSES_ROOT, szCLSIDKey);

    // 删除右键菜单项
    SHDeleteKeyW(HKEY_CLASSES_ROOT, L"txtfile\\shell\\printnamestodebugger");

    return S_OK;
}

（5）优化DllMain

添加DisableThreadLibraryCalls避免不必要的线程附着：

BOOL APIENTRY DllMain( HMODULE hModule,
                       DWORD  ul_reason_for_call,
                       LPVOID lpReserved
                     )
{
    switch (ul_reason_for_call)
    {
    case DLL_PROCESS_ATTACH:
        DisableThreadLibraryCalls(hModule);
        break;
    case DLL_THREAD_ATTACH:
    case DLL_THREAD_DETACH:
    case DLL_PROCESS_DETACH:
        break;
    }
    return TRUE;
}

3. 最终操作步骤 #

1. 修正所有代码错误后，重新编译为64位DLL。
2. 以管理员身份打开命令提示符，执行：

   regsvr32 "C:\Users\Username\OneDrive\Desktop\COM\COMIExecuteCommand.dll"
   

3. 重启资源管理器（或注销后重新登录），右键点击文本文件测试菜单功能。

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