Поделиться через


IFileSyncProviderCallback::OnFileCopyProgress

Периодически возникает, показывая ход выполнения во время копирования файла.

Синтаксис

HRESULT OnFileCopyProgress(
  LPCWSTR pcszNewFilePath, 
  DWORD dwPercentCopied);

Параметры

  • pcszNewFilePath
    [in, string] Путь к копируемому файлу. Путь задается относительно корневого каталога.

  • dwPercentCopied
    [in] Сведения о ходе выполнения операции копирования. Значение выражается в процентах.

Возвращаемое значение

  • S_OK

Замечания

Это событие возникает для каждого блока размером 512 КБ, записанного в файл.

Если размер файла меньше 512 КБ, это событие не возникает.

Это событие не вызывается для указания на завершение операции копирования файла. Вместо этого после завершения копирования вызывается событие IFileSyncProviderCallback::OnChangeApplied.

Если изменение имеет тип FILESYNC_CHANGE_TYPE_RENAME, то параметр pcszNewFilePath содержит обновленный путь к файлу (в состоянии после переименования).

Если OnFileCopyProgress возвращает ошибку, платформа Sync Framework прекращает обработку текущего пакета изменений и возвращает ошибку из метода ProcessChangeBatch интерфейса IFileSyncProvider.

См. также

Другие ресурсы

Интерфейс IFileSyncProviderCallback