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 将停止处理当前的变更批,并从 IFileSyncProviderProcessChangeBatch 方法返回错误。

请参阅

参考

IFileSyncProviderCallback 接口