moveFileA 函数 (winbase.h)

移动现有的文件或目录，包括其子级。

若要指定如何移动文件，请使用 MoveFileEx 或 MoveFileWithProgress 函数。

若要以事务处理操作的形式执行此操作，请使用 MoveFileTransacted 函数。

语法

BOOL MoveFileA(
  [in] LPCSTR lpExistingFileName,
  [in] LPCSTR lpNewFileName
);

[in] lpExistingFileName

本地计算机上的文件或目录的当前名称。

默认情况下，名称限制为MAX_PATH个字符。若要将此限制扩展到 32,767 个宽字符，请在路径前面添加“\？\”。有关详细信息，请参阅命名文件、路径和命名空间。

提示

从 Windows 10 版本 1607 开始，可以选择删除MAX_PATH限制，而无需在前面添加“\\？\”。有关详细信息，请参阅命名文件、路径和命名空间的“最大路径长度限制”部分。

[in] lpNewFileName

文件或目录的新名称。新名称不得已存在。新文件可能位于不同的文件系统或驱动器上。新目录必须位于同一驱动器上。

提示

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

MoveFile 函数将移动 (重命名) 文件或目录 (包括其子级) 在同一目录或跨目录。需要注意的是，当目标位于其他卷上时， MoveFile 函数在目录移动时会失败。

如果文件跨卷移动， MoveFile 不会随文件一起移动安全描述符。将为文件分配目标目录中的默认安全描述符。

MoveFile 函数将其操作与链接跟踪服务协调，因此可以在移动链接源时对其进行跟踪。

在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。

SMB 3.0 不支持重命名具有持续可用性功能的文件共享上的备用数据流。

注意

winbase.h 标头将 MoveFile 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。