Skip to main content

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 调用,用于在复制操作期间报告单个文件的进度。调用频率由 WdCopyStatusCallbacksrefreshRateMs 成员控制。 从该回调返回失败的 HRESULT 将中止复制操作,并从 WdRemoteCopy 返回该错误。 该回调在与 WdRemoteCopy 调用相同的线程上被调用。fileUpdates 数组、copyUpdates 结构体及其内容仅在回调调用期间有效。

要求

另请参阅

最后修改于 2026年8月24日