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 失敗的回呼 HRESULT 會被記錄,但不會中止複製,也不會變更 WdRemoteCopy 傳回的結果。

備註

WdRemoteCopy 會叫用此回呼,以在複製作業期間回報個別檔案的進度。叫用頻率由 WdCopyStatusCallbacks 的 refreshRateMs 成員控制。 此回呼會在與 WdRemoteCopy 呼叫相同的執行緒上叫用。fileUpdates 陣列、copyUpdates 結構及其內容只在回呼叫用期間有效。

需求

另請參閱

Last modified on October 6, 2026