IFileSyncProviderCallback::OnFileCopyProgress
复制文件时定期发生以显示进度。
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 方法返回错误。