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 結構及其內容只在回呼叫用期間有效。
