定期發生來顯示複製檔案時的進度。
HRESULT OnFileCopyProgress(
LPCWSTR pcszNewFilePath,
DWORD dwPercentCopied);
參數
- pcszNewFilePath
[in, string] 要複製之檔案的路徑。此路徑相對於根目錄。
- dwPercentCopied
[in] 複製作業的進度。這項值是以百分比表示。
傳回值
- S_OK
備註
每一個寫入檔案中的 512-KB 區塊都會引發這個事件一次。
如果檔案小於 512 KB，就不會引發這個事件。
不引發這個事件，表示檔案複製作業完成。而在複製檔案之後，將會引發 IFileSyncProviderCallback::OnChangeApplied 事件。
如果變更類型為 FILESYNC_CHANGE_TYPE_RENAME，pcszNewFilePath 會包含在它重新命名之後的更新後檔案路徑。
如果 OnFileCopyProgress 傳回錯誤，Sync Framework 便會停止處理目前的變更批次，並且從 IFileSyncProvider 的 ProcessChangeBatch 方法傳回錯誤。