CopyFileEx

【勇芳软件工作室】汉化HomePreviousNext

[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.

也可以看看

CreateFile, CopyFile, CopyProgressRoutine, MoveFile