背景
在 Windows 平台下进行 C++ 开发时，文件操作不仅仅局限于'读'和'写'，文件拷贝同样是系统级程序中极其常见的需求。例如：
- 文件备份工具
- 安装程序（Installer）
- 更新器 / 补丁程序
- 系统维护与运维工具
- 大文件迁移与进度显示程序
在 C/C++ 标准库中，并没有直接提供一个'可控制、可监控进度'的文件拷贝接口。虽然可以通过 ifstream + ofstream 或 ReadFile + WriteFile 自行实现，但代码复杂、效率和健壮性都依赖开发者经验。
Windows API 为此提供了更专业的解决方案 —— CopyFileEx 系列函数。
其中：
CopyFileA：最基础的文件拷贝CopyFileExA：支持 进度回调、取消拷贝、错误恢复 的高级接口
在实际工程中，只要涉及：
- 拷贝大文件
- 显示拷贝进度
- 用户可中断操作
CopyFileExA 几乎是首选方案。
本项目将以教学 + 工程实战为目标，完整讲解如何在 C++ 中使用 CopyFileExA 实现一个可显示进度的文件拷贝程序。
功能需求
本教学项目需要满足以下需求：
- 使用 Windows API 的
CopyFileExA拷贝文件 - 支持拷贝任意大小的普通文件
- 在拷贝过程中：
- 实时显示拷贝进度百分比
- 显示已拷贝字节数
- 支持用户在回调中中断拷贝（示例中模拟）
- 正确处理常见错误情况：
- 源文件不存在
- 目标文件已存在
- 拷贝失败
- 代码结构清晰、注释完整，适合课堂教学与博客发布
- 所有代码：
- 放在 单个代码块 中
- 不同文件用注释区分
- 代码包含详细中文注释
技术原理
函数概述
CopyFileExA 是 Windows API 中用于 高级文件拷贝 的函数，相比 CopyFileA，它提供了更强的控制能力。
BOOL CopyFileExA( LPCSTR lpExistingFileName, LPCSTR lpNewFileName, LPPROGRESS_ROUTINE lpProgressRoutine, LPVOID lpData, LPBOOL pbCancel, DWORD dwCopyFlags );
参数详细说明
lpExistingFileName
- 源文件路径（ANSI 字符串）
lpNewFileName
- 目标文件路径
