CopyFileEX

CopyFileEx是Windows API中的一个函数，与CopyFile函数类似，用于将一个文件复制到另一个位置。但CopyFileEx提供了更加灵活的文件复制功能，支持异步复制、进度回调等功能。其原型如下：

BOOL CopyFileEx(
  LPCTSTR lpExistingFileName,           // 源文件路径
  LPCTSTR lpNewFileName,                // 目标文件路径
  LPPROGRESS_ROUTINE lpProgressRoutine, // 进度回调函数
  LPVOID lpData,                        // 进度回调函数的参数
  LPBOOL pbCancel,                      // 是否取消操作
  DWORD dwCopyFlags                     // 复制标志
);

函数参数说明：

- lpExistingFileName：源文件的路径和名称。
- lpNewFileName：目标文件的路径和名称。
- lpProgressRoutine：进度回调函数，用于在文件复制过程中获取复制进度。可以为NULL。
- lpData：进度回调函数的参数，会传递给进度回调函数。可以为NULL。
- pbCancel：是否取消操作的标志。可以为NULL。
- dwCopyFlags：复制标志，控制复制行为。可以为以下标志的组合：

- COPY_FILE_FAIL_IF_EXISTS：如果目标文件已存在，则复制失败。
- COPY_FILE_RESTARTABLE：支持断点续传复制。
- COPY_FILE_OPEN_SOURCE_FOR_WRITE：打开源文件以进行写操作。
- COPY_FILE_ALLOW_DECRYPTED_DESTINATION：允许将文件复制到未加密的目标目录。
- COPY_FILE_COPY_SYMLINK：如果源文件是符号链接，则复制符号链接而不是目标文件。
- COPY_FILE_NO_BUFFERING：禁用缓存操作，使用直接I/O操作。

函数返回值为BOOL类型，表示文件是否复制成功。

CopyFileEx函数的使用方法比CopyFile函数稍微复杂一些，下面是一个简单的示例代码：

#include <Windows.h>

DWORD CALLBACK ProgressRoutine(
    LARGE_INTEGER TotalFileSize,
    LARGE_INTEGER TotalBytesTransferred,
    LARGE_INTEGER StreamSize,
    LARGE_INTEGER StreamBytesTransferred,
    DWORD dwStreamNumber,
    DWORD dwCallbackReason,
    HANDLE hSourceFile,
    HANDLE hDestinationFile,
    LPVOID lpData
)
{
    printf("TotalFileSize: %lld bytes\n", TotalFileSize.QuadPart);
    printf("TotalBytesTransferred: %lld bytes\n", TotalBytesTransferred.QuadPart);
    printf("StreamSize: %lld bytes\n", StreamSize.QuadPart);
    printf("StreamBytesTransferred: %lld bytes\n", StreamBytesTransferred.QuadPart);
    printf("StreamNumber: %d\n", dwStreamNumber);
    printf("CallbackReason: %d\n", dwCallbackReason);

    return PROGRESS_CONTINUE;
}

int main()
{
    LPCTSTR lpSrcFile = "C:\\test\\src.txt";
    LPCTSTR lpDstFile = "C:\\test\\dst.txt";
    BOOL bSuccess = CopyFileEx(lpSrcFile, lpDstFile, ProgressRoutine, NULL, NULL, 0);
    if (bSuccess)
    {
        printf("Copy file success.\n");
    }
    else
    {
        printf("Copy file failed.\n");
    }
    return 0;
}

这个例子会将C盘下的test文件夹中的src.txt文件复制到dst.txt文件中，并输出复制进度。