WdCopyFilesStatusCallback
在复制操作期间被调用以报告文件复制进度。语法
参数
fileProgressCount _In_类型:size_t 自上次回调调用以来具有进度更新的文件数量。
fileUpdates _In_reads_opt_(fileProgressCount)类型:const WdCopyFileProgressInfo* 指向 WdCopyFileProgressInfo 结构体数组的指针,每个结构体包含单个文件的进度信息。如果
fileProgressCount 为 0,则可以为 nullptr。
copyUpdates _In_类型:const WdCopyOperationSummary* 指向 WdCopyOperationSummary 结构体的指针,该结构体包含整体复制操作进度的摘要。
context _In_opt_
类型:void*
在 WdCopyStatusCallbacks 结构体中指定的用户自定义上下文指针。
返回值
类型:HRESULT 返回S_OK 以继续复制操作。返回失败的 HRESULT 以中止复制。
备注
此回调由 WdRemoteCopy 调用,用于在复制操作期间报告单个文件的进度。调用频率由 WdCopyStatusCallbacks 的refreshRateMs 成员控制。
从该回调返回失败的 HRESULT 将中止复制操作,并从 WdRemoteCopy 返回该错误。
该回调在与 WdRemoteCopy 调用相同的线程上被调用。fileUpdates 数组、copyUpdates 结构体及其内容仅在回调调用期间有效。
