目录

一、MoveFile

参数

返回值

使用示例

注意事项

二、MoveFileEx

参数

返回值

使用示例

三、MoveFileWithProgress

参数

返回值

使用示例

注意事项

四、CopyFile

参数

返回值

使用示例

注意事项

五、CopyFileEx

参数

返回值

使用示例

注意事项

六、总结

     

        MoveFile、MoveFileEx、MoveFileWithProgress、CopyFile、CopyFileEx，这些函数在文件和目录的创建、删除、移动、查找等操作中提供了额外的功能和灵活性，能够帮助开发者进行更复杂的文件管理任务。

一、MoveFile

BOOL MoveFile(
  LPCTSTR lpExistingFileName, // 要移动或重命名的现有文件的名称
  LPCTSTR lpNewFileName        // 新文件名或目标文件的名称
);

参数

  • lpExistingFileName: 指向一个以 null 结尾的字符串，指定要移动或重命名的现有文件的路径。
  • lpNewFileName: 指向一个以 null 结尾的字符串，指定新文件名或目标路径。如果目标路径在不同的目录中，文件将被移动到该目录；如果在同一目录中，文件将被重命名。

返回值

  • 如果函数成功，返回值为非零值。
  • 如果函数失败，返回值为零。可以调用 GetLastError 函数获取更多错误信息。

使用示例

        下面是一个示例，展示如何使用 MoveFile 函数将文件从一个位置移动到另一个位置。

#include <windows.h>
#include <iostream>

void MoveFileExample() {
    LPCSTR existingFileName = "C:\\Temp\\example.txt"; // 现有文件路径
    LPCSTR newFileName = "C:\\Temp\\new_example.txt";  // 新文件路径

    // 尝试移动文件
    if (MoveFile(existingFileName, newFileName)) {
        std::cout << "文件移动成功！" << std::endl;
    } else {
        std::cout << "文件移动失败，错误代码: " << GetLastError() << std::endl;
    }
}

int main() {
    MoveFileExample();
    return 0;
}

注意事项

  • 确保程序有足够的权限访问指定的文件和目录。
  • 如果目标文件已经存在，MoveFile 将失败。可以使用 MoveFileEx 函数并结合 MOVEFILE_REPLACE_EXISTING 标志来替换目标文件。

二、MoveFileEx

   MoveFileEx 函数用于移动文件或文件夹，并提供额外选项，如在重启时删除文件。

BOOL MoveFileEx(
  LPCTSTR lpExistingFileName, // 要移动的现有文件或文件夹的名称
  LPCTSTR lpNewFileName        // 新文件名或目标文件夹的名称
  DWORD dwFlags                // 操作标志
);

参数

  • lpExistingFileName: 指向一个以 null 结尾的字符串，指定要移动的现有文件或文件夹的路径。
  • lpNewFileName: 指向一个以 null 结尾的字符串，指定新的文件名或目标文件夹的路径。
  • dwFlags: 操作标志，决定函数的行为。常用标志包括：
    • MOVEFILE_REPLACE_EXISTING: 如果目标文件已存在，则替换它。
    • MOVEFILE_DELAY_UNTIL_REBOOT: 将文件标记为在下次重启时删除。
    • MOVEFILE_WRITE_THROUGH: 确保所有写入操作在返回之前完成。

返回值

  • 如果函数成功，返回值为非零值。
  • 如果函数失败，返回值为零。可以使用 GetLastError 获取更多错误信息。

使用示例

以下示例演示如何使用 MoveFileEx 函数将文件移动到新位置，同时使用标志。

#include <windows.h>
#include <iostream>

void MoveFileExExample() {
    LPCSTR existingFileName = "C:\\Temp\\example.txt"; // 现有文件路径
    LPCSTR newFileName = "C:\\Temp\\new_example.txt";   // 新文件路径

    // 尝试移动文件并替换现有文件
    if (MoveFileEx(existingFileName, newFileName, MOVEFILE_REPLACE_EXISTING)) {
        std::cout << "文件移动成功！" << std::endl;
    } else {
        std::cout << "文件移动失败，错误代码: " << GetLastError() << std::endl;
    }

    // 如果要在重启时删除文件
    // MoveFileEx(existingFileName, NULL, MOVEFILE_DELAY_UNTIL_REBOOT);
}

int main() {
    MoveFileExExample();
    return 0;
}

        

        以下是使用 MOVEFILE_DELAY_UNTIL_REBOOT 标志的代码示例，它将指定的文件标记为在下次重启时删除。

#include <windows.h>
#include <iostream>

void DeleteFileOnRebootExample() {
    LPCSTR fileToDelete = "C:\\Temp\\example.txt"; // 要在重启时删除的文件路径

    // 尝试将文件标记为在下次重启时删除
    if (MoveFileEx(fileToDelete, NULL, MOVEFILE_DELAY_UNTIL_REBOOT)) {
        std::cout << "文件已标记为在重启时删除！" << std::endl;
    } else {
        std::cout << "标记文件删除失败，错误代码: " << GetLastError() << std::endl;
    }
}

int main() {
    DeleteFileOnRebootExample();
    return 0;
}

三、MoveFileWithProgress

 MoveFileWithProgress 函数用于移动文件，并允许提供进度反馈。

BOOL MoveFileWithProgress(
  LPCTSTR lpExistingFileName,       // 要移动的现有文件的名称
  LPCTSTR lpNewFileName              // 新文件名或目标文件的名称
  LPPROGRESS_ROUTINE lpProgressProc, // 指向进度例程的指针
  LPVOID lpData                      // 传递给进度例程的数据
  DWORD dwFlags                      // 操作标志
);

参数

  • lpExistingFileName: 指向一个以 null 结尾的字符串，指定要移动的现有文件的路径。
  • lpNewFileName: 指向一个以 null 结尾的字符串，指定新的文件名或目标文件的路径。
  • lpProgressProc: 指向一个回调函数（进度例程）的指针，用于接收进度更新。
  • lpData: 指向用户定义的数据，可以传递给进度例程。
  • dwFlags: 操作标志，例如 MOVEFILE_COPY_ALLOWED。

 

返回值

  • 如果函数成功，返回值为非零值。
  • 如果函数失败，返回值为零。可以使用 GetLastError 获取更多错误信息。

使用示例

        以下示例演示如何使用 MoveFileWithProgress 函数移动文件并实现进度反馈。

#include <windows.h>
#include <iostream>

// 进度回调函数
DWORD CALLBACK ProgressRoutine(
    LARGE_INTEGER TotalFileSize,
    LARGE_INTEGER TotalBytesTransferred,
    LARGE_INTEGER StreamSize,
    LARGE_INTEGER StreamBytesTransferred,
    DWORD dwStreamNumber,
    DWORD dwCallbackReason,
    HANDLE hSourceFile,
    HANDLE hDestinationFile,
    DWORD dwData)
{
    // 输出进度信息
    double percent = (static_cast<double>(TotalBytesTransferred.QuadPart) / TotalFileSize.QuadPart) * 100.0;
    std::cout << "已移动: " << TotalBytesTransferred.QuadPart << " 字节 (" << percent << "%)" << std::endl;
    return PROGRESS_CONTINUE; // 继续移动
}

void MoveFileWithProgressExample() {
    LPCSTR existingFileName = "C:\\Temp\\example.txt"; // 现有文件路径
    LPCSTR newFileName = "C:\\Temp\\new_example.txt";   // 新文件路径

    // 尝试移动文件并提供进度反馈
    if (MoveFileWithProgress(existingFileName, newFileName, ProgressRoutine, NULL, MOVEFILE_COPY_ALLOWED)) {
        std::cout << "文件移动成功！" << std::endl;
    } else {
        std::cout << "文件移动失败，错误代码: " << GetLastError() << std::endl;
    }
}

int main() {
    MoveFileWithProgressExample();
    return 0;
}

注意事项

  • 确保程序有足够的权限访问指定的文件和目录。
  • 进度回调函数可以根据需要进行扩展，以实现更多功能（例如，取消操作）。

四、CopyFile

  CopyFile 函数用于复制文件。

BOOL CopyFile(
  LPCTSTR lpExistingFileName, // 要复制的现有文件的名称
  LPCTSTR lpNewFileName,      // 新文件的名称
  BOOL bFailIfExists          // 如果目标文件已存在，是否失败
);

参数

  • lpExistingFileName: 指向一个以 null 结尾的字符串，指定要复制的现有文件的路径。
  • lpNewFileName: 指向一个以 null 结尾的字符串，指定新文件的路径。
  • bFailIfExists: 如果该参数为 TRUE，并且目标文件已存在，则函数将失败。如果为 FALSE，目标文件将被覆盖。

 

返回值

  • 如果函数成功，返回值为非零值。
  • 如果函数失败，返回值为零。可以使用 GetLastError 获取更多错误信息。

使用示例

        以下示例演示如何使用 CopyFile 函数复制文件。

#include <windows.h>
#include <iostream>

void CopyFileExample() {
    LPCSTR existingFileName = "C:\\Temp\\example.txt"; // 现有文件路径
    LPCSTR newFileName = "C:\\Temp\\copy_of_example.txt"; // 新文件路径

    // 尝试复制文件
    if (CopyFile(existingFileName, newFileName, FALSE)) {
        std::cout << "文件复制成功！" << std::endl;
    } else {
        std::cout << "文件复制失败，错误代码: " << GetLastError() << std::endl;
    }
}

int main() {
    CopyFileExample();
    return 0;
}

注意事项

  • 确保程序有足够的权限访问指定的文件和目录。
  • 如果目标文件已存在并且 bFailIfExists 参数为 TRUE，复制操作将失败；如果为 FALSE，目标文件将被覆盖。

 

五、CopyFileEx

  CopyFileEx 函数用于复制文件，并提供进度反馈和取消操作的功能。

BOOL CopyFileEx(
  LPCTSTR lpExistingFileName,         // 要复制的现有文件的名称
  LPCTSTR lpNewFileName,              // 新文件的名称
  LPPROGRESS_ROUTINE lpProgressProc,  // 指向进度例程的指针
  LPVOID lpData                       // 传递给进度例程的数据
  DWORD dwCopyFlags                   // 操作标志
);

参数

  • lpExistingFileName: 指向一个以 null 结尾的字符串，指定要复制的现有文件的路径。

  • lpNewFileName: 指向一个以 null 结尾的字符串，指定新文件的路径。

  • lpProgressProc: 指向一个回调函数的指针，允许在复制过程中接收进度更新。该函数可以提供实时反馈。

  • lpData: 指向用户定义的数据，可以在进度例程中使用。可以传递任何您需要的信息，通常是用于传递上下文信息的指针。

  • dwCopyFlags: 操作标志，决定复制操作的行为。常用标志包括：

    • COPY_FILE_FAIL_IF_EXISTS: 如果目标文件已存在，复制操作将失败。
    • COPY_FILE_RESTARTABLE: 创建可以恢复的复制操作。
    • COPY_FILE_OPEN_SOURCE_FOR_WRITE: 允许源文件在复制过程中被写入。
    • COPY_FILE_ALLOW_DECRYPTED_DESTINATION: 允许将未加密文件复制到未加密目标。

返回值

  • 如果函数成功，返回值为非零值。
  • 如果函数失败，返回值为零。可以使用 GetLastError 获取更多错误信息。

使用示例

        以下示例演示如何使用 CopyFileEx 函数复制文件并提供进度反馈。

#include <windows.h>
#include <iostream>

// 进度回调函数
DWORD CALLBACK ProgressRoutine(
    LARGE_INTEGER TotalFileSize,
    LARGE_INTEGER TotalBytesTransferred,
    LARGE_INTEGER StreamSize,
    LARGE_INTEGER StreamBytesTransferred,
    DWORD dwStreamNumber,
    DWORD dwCallbackReason,
    HANDLE hSourceFile,
    HANDLE hDestinationFile,
    DWORD dwData)
{
    // 输出进度信息
    double percent = (static_cast<double>(TotalBytesTransferred.QuadPart) / TotalFileSize.QuadPart) * 100.0;
    std::cout << "已复制: " << TotalBytesTransferred.QuadPart << " 字节 (" << percent << "%)" << std::endl;
    return PROGRESS_CONTINUE; // 继续复制
}

void CopyFileExExample() {
    LPCSTR existingFileName = "C:\\Temp\\example.txt"; // 现有文件路径
    LPCSTR newFileName = "C:\\Temp\\copy_of_example.txt"; // 新文件路径

    // 尝试复制文件并提供进度反馈
    if (CopyFileEx(existingFileName, newFileName, ProgressRoutine, NULL, NULL, 0)) {
        std::cout << "文件复制成功！" << std::endl;
    } else {
        std::cout << "文件复制失败，错误代码: " << GetLastError() << std::endl;
    }
}

int main() {
    CopyFileExExample();
    return 0;
}

注意事项

  • 确保程序有足够的权限访问指定的文件和目录。
  • 进度回调函数可以根据需要进行扩展，以实现更多功能（例如，取消操作）。

六、总结

        文件管理是一个至关重要的领域，涉及文件的创建、移动、复制和删除等操作。本文介绍了五个关键的 Windows API 函数：MoveFile、MoveFileEx、MoveFileWithProgress、CopyFile 和 CopyFileEx，这些函数在实现高效的文件操作时，提供了丰富的功能和灵活性。

  MoveFile 是最基本的文件移动函数，允许开发者轻松地将文件或目录移动到指定位置或重命名。尽管功能简单，但它的有效性在于易用性，适合进行快速的文件操作。然而，它的局限性在于无法处理已存在的目标文件，这为更复杂的应用场景带来了挑战。

        为了解决这个问题，MoveFileEx 提供了更高的灵活性，不仅支持替换现有文件，还能设置在系统重启后删除文件的选项。这样的特性对于需要在文件被占用或锁定时进行管理的应用程序尤为重要，开发者可以通过这个函数来实现更复杂的逻辑，确保系统的稳定性和文件的完整性。

   MoveFileWithProgress 则在移动文件时引入了进度反馈机制，使开发者能够实时监控文件移动的状态。这在处理大文件时尤为重要，因为用户可以通过进度反馈了解操作的进展，避免因长时间的等待而产生的不安。这种交互性极大提升了用户体验，使得文件操作不再是一个“黑箱”过程。

        在复制文件方面，CopyFile 和 CopyFileEx 提供了类似的功能。前者以简单直接的方式实现文件复制，但缺乏进度反馈和更高级的控制。而 CopyFileEx 则弥补了这一不足，通过提供进度回调函数，开发者可以在复制过程中获取实时反馈。这在复制大文件或在网络环境下复制文件时尤其重要，因为可以实现对操作的动态监控和用户交互。

        总结来说，这些 API 函数为开发者提供了强大的工具，能够高效地管理文件和目录操作。无论是基本的文件移动、复杂的文件替换还是在长时间操作中的进度反馈，这些函数都为实现优雅而灵活的文件管理解决方案奠定了基础。在实际开发中，正确地选择和使用这些函数，不仅能够提升应用程序的性能，还能极大地改善用户体验。因此，理解这些函数的使用场景、优缺点及其适用性，对于每一位软件开发者来说，都是必不可少的技能。通过深入掌握这些 API，开发者能够在日益复杂的文件操作中游刃有余，实现更加流畅和高效的应用程序。

# windows # c++ # 开发语言
Logo
西安城市开发者社区

欢迎加入西安开发者社区！我们致力于为西安地区的开发者提供学习、合作和成长的机会。参与我们的活动，与专家分享最新技术趋势，解决挑战，探索创新。加入我们，共同打造技术社区！

更多推荐

cover

猫头虎分享：鸿蒙生态带给开发者的全新机遇！轻松实现按需加载与多端适配，开发效率翻倍

avatar 西安城市开发者社区
cover

如何解决ffmpeg安装报错ERROR: You have requested merging of multiple formats but ffmpeg is not installed

avatar 西安城市开发者社区
cover

猫头虎分享Python 编码转换库：处理 JSONL 编码格式转换的最佳实践

avatar 西安城市开发者社区