.NET 8 COM托管实现Explorer自定义.t1k文件InfoTip异常问题

核心问题分析 #

你的DLL被Explorer加载但不显示自定义提示，核心原因是InfoTip处理程序必须同时实现IPersistFile接口——Windows Shell需要通过这个接口传递目标文件的路径，否则无法完成组件初始化，会直接跳过你的实现使用默认提示。此外，COM接口的签名和注册表配置也需要严格匹配。

步骤1：修正代码，添加IPersistFile实现 #

更新你的类，同时实现IQueryInfo和IPersistFile，确保接口定义符合COM规范：

using System.Runtime.InteropServices;

namespace T1000ShellEx
{
    [ComVisible(true)]
    [Guid("E2B9C5B6-5C92-4D1B-85E6-2F80B72F6E28")]
    [ClassInterface(ClassInterfaceType.None)]
    public sealed class T1KInfoTipHandler : IPersistFile, IQueryInfo
    {
        private string _currentFilePath;

        // IPersistFile 实现
        public int GetClassID(out Guid pClassID)
        {
            pClassID = typeof(T1KInfoTipHandler).GUID;
            return 0;
        }

        public int IsDirty() => 0;

        public int Load([MarshalAs(UnmanagedType.LPWStr)] string pszFileName, uint dwMode)
        {
            _currentFilePath = pszFileName;
            return 0;
        }

        public int Save([MarshalAs(UnmanagedType.LPWStr)] string pszFileName, bool fRemember) => 0;
        public int SaveCompleted([MarshalAs(UnmanagedType.LPWStr)] string pszFileName) => 0;
        public int GetCurFile([MarshalAs(UnmanagedType.LPWStr)] out string ppszFileName)
        {
            ppszFileName = _currentFilePath;
            return 0;
        }

        // IQueryInfo 实现
        public int GetInfoTip(uint dwFlags, out string ppwszTip)
        {
            try
            {
                // 可使用_currentFilePath读取文件内容生成自定义提示
                ppwszTip = $"IT WORKS: {_currentFilePath}";
                return 0;
            }
            catch
            {
                ppwszTip = "ERROR";
                return 0;
            }
        }

        public int GetInfoFlags(out uint pdwFlags)
        {
            pdwFlags = 0;
            return 0;
        }
    }

    [ComVisible(true)]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    [Guid("0000010b-0000-0000-C000-000000000046")]
    public interface IPersistFile
    {
        [PreserveSig]
        int GetClassID(out Guid pClassID);
        [PreserveSig]
        int IsDirty();
        [PreserveSig]
        int Load([MarshalAs(UnmanagedType.LPWStr)] string pszFileName, uint dwMode);
        [PreserveSig]
        int Save([MarshalAs(UnmanagedType.LPWStr)] string pszFileName, bool fRemember);
        [PreserveSig]
        int SaveCompleted([MarshalAs(UnmanagedType.LPWStr)] string pszFileName);
        [PreserveSig]
        int GetCurFile([MarshalAs(UnmanagedType.LPWStr)] out string ppszFileName);
    }

    [ComVisible(true)]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    [Guid("00021500-0000-0000-C000-000000000046")]
    public interface IQueryInfo
    {
        [PreserveSig]
        int GetInfoTip(uint dwFlags, [MarshalAs(UnmanagedType.LPWStr)] out string ppwszTip);
        [PreserveSig]
        int GetInfoFlags(out uint pdwFlags);
    }
}

步骤2：验证注册表配置 #

使用regsvr32.exe /i T1000ShellEx.comhost.dll注册后，检查以下注册表项是否正确：

• 路径：HKEY_CLASSES_ROOT\CLSID\{E2B9C5B6-5C92-4D1B-85E6-2F80B72F6E28}
• 确保InprocServer32默认值指向你的T1000ShellEx.comhost.dll完整路径，且ThreadingModel设置为Apartment（Shell扩展要求单线程单元）

若需手动维护注册表，补充CLSID项：

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\CLSID\{E2B9C5B6-5C92-4D1B-85E6-2F80B72F6E28}]
@="T1000 InfoTip Handler"

[HKEY_CLASSES_ROOT\CLSID\{E2B9C5B6-5C92-4D1B-85E6-2F80B72F6E28}\InprocServer32]
@="C:\\Path\\To\\Your\\T1000ShellEx.comhost.dll"
"ThreadingModel"="Apartment"

[HKEY_CLASSES_ROOT\CLSID\{E2B9C5B6-5C92-4D1B-85E6-2F80B72F6E28}\ProgID]
@="T1000ShellEx.T1KInfoTipHandler"

步骤3：调试确认调用 #

在GetInfoTip或Load方法开头添加调试触发代码，确认代码是否被执行：

System.Diagnostics.Debugger.Launch();

编译后重新注册，鼠标悬停在.t1k文件上时会弹出调试器选择窗口，附加到Explorer进程即可单步调试。

额外注意事项 #

• 平台目标：必须设置为x64（64位系统下Explorer为64位进程，32位DLL无法加载）
• .NET运行时：确保目标机器安装了.NET 8 Desktop Runtime
• Shell缓存：修改扩展后，需重启Explorer或执行ie4uinit.exe -show清除Shell缓存

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