[New - Windows NT]
CopyFileEx功能将现有文件复制到新文件。此函数保留扩展属性,OLE结构化存储,NTFS备用数据流和文件属性。现有文件的安全属性不会复制到新文件中。
BOOL CopyFileEx(
LPCWSTR 【lpExistingFileName】, | //指向现有文件名称的指针 |
LPCWSTR【lpNewFileName】, | //指向要复制到的文件名的指针 |
LPPROGRESS_ROUTINE 【lpProgressRoutine】, | //指向回调函数的指针 |
LPVOID 【的lpData】, | //传递给回调函数 |
LPBOOL 【// flag that can be used to cancel the operation】, | //可以用来取消该操作的标志 |
DWORD 【dwCopyFlags】 | //指定如何复制文件的标志 |
); |
参数
【lpExistingFileName】
指向以空字符结尾的字符串,指定现有文件的名称。
【lpNewFileName】
指向以空字符结尾的字符串,指定新文件的名称。
【lpProgressRoutine】
指定每次复制文件的另一部分时调用的类型为LPPROGRESS_ROUTINE的回调函数的地址。此参数可以为NULL。有关进度回调函数的更多信息,请参阅CopyProgressRoutine.
【的lpData】
指定要传递给回调函数的参数。此参数可以为NULL。
【// flag that can be used to cancel the operation】
指向可用于取消操作的布尔变量。如果在复制操作期间该标志设置为TRUE,则操作将被取消。
【dwCopyFlags】
指定文件的复制方式。此参数可以是以下值的组合:
值 | 含义 |
COPY_FILE_FAIL_IF_EXISTS | 如果目标文件已经存在,复制操作将立即失败。 |
COPY_FILE_RESTARTABLE | 副本的进度在目标文件中被跟踪,以防复制失败。可以通过与【lpExistingFileName】和【lpNewFileName】相同的值重新启动失败的副本,因为失败的调用中使用的那些值。 |
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
有关文件属性的信息,请参阅CreateFile.
也可以看看