使用C# Shell32.NameSpace提取音乐文件元数据时遇E_FAIL错误

问题重现 #

使用.NET6通过Shell32读取音乐文件元数据时，频繁触发COMException，错误信息为：

Error HRESULT E_FAIL has been returned from a call to a COM component

错误代码-2147467259（十六进制-0x7FFFBFFB），已确认仅处理存在的文件，且通过以下代码解决过Shell32的STA线程启动问题：

Thread.CurrentThread.SetApartmentState(ApartmentState.Unknown);
Thread.CurrentThread.SetApartmentState(ApartmentState.STA);

核心原因 #

你的代码中调用shell.NameSpace(file.FullName)时传入了文件的完整路径，但Shell32.Shell.NameSpace()方法要求传入的是文件夹路径，而非单个文件路径。传入文件路径会导致Shell无法正确解析为文件夹对象，直接触发E_FAIL异常。

解决方案 #

1. 修正NameSpace参数 #

将file.FullName替换为file.DirectoryName，传入文件所在的文件夹路径：

objFolder = shell.NameSpace(file.DirectoryName);

2. 正确获取FolderItem #

通过文件夹对象解析文件名来获取目标文件的FolderItem：

Shell32.FolderItem folderItem = objFolder.ParseName(file.Name);

3. 释放COM对象（可选但推荐） #

Shell32对象属于COM组件，使用后需手动释放以避免资源泄漏，可借助Marshal.ReleaseComObject：

finally
{
    if (folderItem != null) Marshal.ReleaseComObject(folderItem);
    if (objFolder != null) Marshal.ReleaseComObject(objFolder);
    if (shell != null) Marshal.ReleaseComObject(shell);
}

4. 确保STA线程有效性 #

如果是控制台应用的顶级语句，可将Shell32操作封装到STA线程中执行，避免线程公寓状态问题：

var song = default(Song);
var staThread = new Thread(() =>
{
    song = ConvertFileToSong(fileInfo);
});
staThread.SetApartmentState(ApartmentState.STA);
staThread.Start();
staThread.Join();

调整后的完整代码 #

using System.Runtime.InteropServices;

public static Song ConvertFileToSong(FileInfo file)
{
    Song song = new Song();
    List<string> headers = new List<string>();

    Shell32.Shell shell = new Shell32.Shell();
    Shell32.Folder objFolder = null;
    Shell32.FolderItem folderItem = null;

    try 
    {
        // 传入文件夹路径而非文件路径
        objFolder = shell.NameSpace(file.DirectoryName); 
        if (objFolder == null) return null;

        // 解析文件名获取文件对象
        folderItem = objFolder.ParseName(file.Name);
        if (folderItem == null) return null;

        // 枚举所有可用元数据头
        for (int i = 0; i < short.MaxValue; i++)
        {
            string header = objFolder.GetDetailsOf(null, i);
            if (string.IsNullOrEmpty(header)) break;
            headers.Add(header);
        }

        // 获取标题元数据（索引0对应文件名，实际音乐标题需用对应索引，比如21）
        // 注意：不同系统/Shell版本的索引可能有差异，建议通过headers列表匹配关键字获取索引
        song.Title = objFolder.GetDetailsOf(folderItem, 21);
    }
    catch (COMException e) 
    {
        int code = e.ErrorCode;
        string hex = code.ToString("X");
        Console.WriteLine($"MESSAGE: {e.Message}, CODE: {hex}");
        return null;
    }
    finally
    {
        // 释放COM资源
        if (folderItem != null) Marshal.ReleaseComObject(folderItem);
        if (objFolder != null) Marshal.ReleaseComObject(objFolder);
        if (shell != null) Marshal.ReleaseComObject(shell);
    }

    return song;
}

额外提示 #

• 元数据索引（比如标题对应的21）可能因Windows版本、区域设置不同而变化，建议通过headers列表查找对应关键字的索引，而非硬编码数字。
• 如果仍有异常，可尝试以管理员权限运行程序，排查文件权限问题。

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