求助：任务计划程序无法识别映射驱动器的SharePoint下载任务

一、解决任务计划程序无法识别映射驱动器的问题 #

任务计划程序即使设置为「仅在用户登录时运行」，其运行环境的驱动器映射会话也可能和用户手动登录时不同，导致无法识别预先配置的映射。推荐两种实用解决方式：

1. 在C#程序内部主动映射驱动器 #

通过调用Windows API在程序启动时完成驱动器映射，不依赖系统预先配置的映射，彻底规避环境差异问题。示例代码：

using System;
using System.Runtime.InteropServices;

public class DriveMapper
{
    [DllImport("mpr.dll", CharSet = CharSet.Unicode, SetLastError = true)]
    private static extern int WNetAddConnection2(ref NETRESOURCE lpNetResource, string lpPassword, string lpUsername, int dwFlags);

    [DllImport("mpr.dll", CharSet = CharSet.Unicode, SetLastError = true)]
    private static extern int WNetCancelConnection2(string lpName, int dwFlags, bool fForce);

    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
    private struct NETRESOURCE
    {
        public int dwScope;
        public int dwType;
        public int dwDisplayType;
        public int dwUsage;
        public string lpLocalName;
        public string lpRemoteName;
        public string lpComment;
        public string lpProvider;
    }

    // 映射驱动器
    public static bool MapDrive(string driveLetter, string networkPath, string username = null, string password = null)
    {
        var nr = new NETRESOURCE
        {
            dwType = 0x00000001, // RESOURCETYPE_DISK
            lpLocalName = driveLetter + ":",
            lpRemoteName = networkPath
        };

        int result = WNetAddConnection2(ref nr, password, username, 0);
        return result == 0;
    }

    // 断开驱动器（可选，程序退出时调用）
    public static bool UnmapDrive(string driveLetter, bool force = false)
    {
        int result = WNetCancelConnection2(driveLetter + ":", 0, force);
        return result == 0;
    }
}

// 程序启动时调用示例
// MapDrive("Z", @"\\your-server\target-share", "domain\your-account", "your-password");

注意：域账号需传入domain\username格式；明文存储密码存在安全风险，可改用Windows凭据管理器读取加密凭据。

2. 任务计划中先执行映射命令再启动EXE #

若不想修改程序，可在任务计划的「操作」中添加两步执行逻辑：

• 第一步：启动cmd.exe，参数填/c "net use Z: \\your-server\target-share /user:domain\your-account your-password"
• 第二步：启动你的C# EXE文件
  此方式需明文填写密码，仅适合内部封闭环境使用。

二、解决路径长度超过256字符的问题 #

针对嵌套文件夹导致的长路径问题，结合映射驱动器场景，推荐以下两种方案：

1. 开启.NET长路径支持（推荐） #

从.NET Framework 4.6.2、.NET Core 2.0开始，框架原生支持长路径，只需两步配置：

• 系统层面：Windows 10 1607+/Windows Server 2016+系统中，开启组策略计算机配置>管理模板>系统>文件系统>启用 Win32 长路径（未开启则框架支持失效）
• 程序层面：
  • .NET Framework：在App.config中添加配置

    <configuration>
      <runtime>
        <AppContextSwitchOverrides value="Switch.System.IO.PathEnableLongPaths=true" />
      </runtime>
    </configuration>
    

  • .NET Core/.NET 5+：无需额外配置，默认已启用（需系统层面开启长路径）

配置完成后，程序中使用常规路径写法（如Z:\deep\nested\folder\...）即可自动突破256字符限制。

2. 手动添加\\?\路径前缀 #

若使用较旧.NET版本，可手动给路径添加\\?\前缀：

• 映射驱动器路径示例：将Z:\long\path\structure改为\\?\Z:\long\path\structure
• 注意：部分旧版.NET API可能不支持该前缀，需测试确认；使用Path.Combine时需手动拼接前缀，避免框架自动截断。

三、额外注意事项 #

• 任务计划运行用户需拥有SharePoint库的下载权限和网络驱动器的写入权限
• 400GB大文件下载需实现断点续传逻辑，避免中途失败重新下载全部数据
• 程序需添加异常捕获和日志记录，方便排查任务运行中的问题

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