如何在C#中正确使用SHFileOperation解决文件夹移动异常？

异常原因 #

你遇到的封送异常，核心问题是SHFILEOPSTRUCT结构体中fAnyOperationsAborted字段的类型映射错误。原生Windows API里该字段是BOOL类型（32位整数），C#默认的int类型未明确指定封送规则，导致CLR无法正确转换托管/非托管类型。

修正方案 #

1. 修正结构体及枚举定义 #

首先需要确保SHFILEOPSTRUCT的字段封送规则正确，同时补全必要的FO（操作类型）和FOF（操作标志）枚举：

using System;
using System.Runtime.InteropServices;

public enum FO : uint
{
    FO_MOVE = 0x0001,
    FO_COPY = 0x0002,
    FO_DELETE = 0x0003,
    FO_RENAME = 0x0004
}

[Flags]
public enum FOF : ushort
{
    FOF_SILENT = 0x0004,           // 不显示进度对话框
    FOF_NOCONFIRMATION = 0x0010,   // 不弹出确认对话框
    FOF_NOCONFIRMMKDIR = 0x0200,   // 创建目录时不确认
    FOF_NOERRORUI = 0x0400,        // 出错时不显示UI
    FOF_FILESONLY = 0x0080         // 仅操作文件（如果路径是目录，需去掉此标志）
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
public struct SHFILEOPSTRUCT
{
    public IntPtr hwnd;
    public FO wFunc;
    [MarshalAs(UnmanagedType.LPTStr)]
    public string pFrom;
    [MarshalAs(UnmanagedType.LPTStr)]
    public string pTo;
    public FOF fFlags;
    [MarshalAs(UnmanagedType.Bool)] // 关键：指定封送为BOOL类型
    public bool fAnyOperationsAborted;
    public IntPtr hNameMappings;
    [MarshalAs(UnmanagedType.LPTStr)]
    public string lpszProgressTitle;
}

2. 正确实现MoveFolder方法 #

调用SHFileOperation时，必须设置关键参数，同时注意路径格式要求：

[DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = true)]
static extern int SHFileOperation(ref SHFILEOPSTRUCT lpFileOp);

public void MoveFolder(string oldPath, string newPath)
{
    // 路径必须以双空字符结尾（支持多路径分隔，单路径也需遵循此格式）
    string fromPath = oldPath + "\0\0";
    string toPath = newPath + "\0\0";

    SHFILEOPSTRUCT fileOp = new SHFILEOPSTRUCT();
    fileOp.hwnd = IntPtr.Zero; // 无父窗口，可根据需求设置
    fileOp.wFunc = FO.FO_MOVE; // 指定移动操作
    fileOp.pFrom = fromPath;
    fileOp.pTo = toPath;
    // 设置操作标志，可根据需求调整
    fileOp.fFlags = FOF_NOCONFIRMATION | FOF_NOCONFIRMMKDIR | FOF_NOERRORUI;
    fileOp.fAnyOperationsAborted = false;
    fileOp.lpszProgressTitle = null;

    int result = SHFileOperation(ref fileOp);

    // 检查操作结果：0表示成功，非0为错误
    if (result != 0 || fileOp.fAnyOperationsAborted)
    {
        // 处理错误，可通过Marshal.GetLastWin32Error()获取错误码
        throw new System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error());
    }
}

额外注意事项 #

• 权限问题：原问题提到的"路径访问被拒绝"，需要确保程序有足够权限访问源路径和目标路径（比如以管理员身份运行，或目标路径不是系统保护目录）。
• 路径格式：源路径和目标路径必须是合法的绝对路径，且双空字符结尾是SHFileOperation的强制要求。
• API替代：SHFileOperation是较旧的API，Windows Vista及以上系统推荐使用IFileOperation接口，它提供更灵活的操作和更好的错误处理，但如果必须兼容旧系统，上述方案依然有效。

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