Метод IFileOperationProgressSink::UpdateProgress (shobjidl_core.h)

Предоставляет оценку общего объема выполненных в данный момент работ по отношению к общему объему работ.

Синтаксис

HRESULT UpdateProgress(
  [in] UINT iWorkTotal,
  [in] UINT iWorkSoFar
);

Параметры

[in] iWorkTotal

Тип: UINT

Оценка объема работ, которые должны быть завершены.

[in] iWorkSoFar

Тип: UINT

Часть iWorkTotal , которая была завершена к настоящему времени.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Значения iWorkTotal и iWorkSoFar — это "баллы" или оценки объема выполняемой работы и объема завершенной работы. Они не указаны в каких-либо конкретных единицах, но должны быть примерно пропорционально тому, сколько времени занимает общий процесс. Например, для копирования одного небольшого файла можно считать две точки, а большой файл — десять пунктов. Если процесс выполняет операцию, которая копирует пять небольших файлов и один большой файл, и процесс завершил четыре небольших файла, iWorkSoFar будет иметь восемь точек (4 x 2 = 8), а iWorkTotal — двадцать пунктов (5 x 2 + 10 = 20), поэтому оценка будет 8 из 20 пунктов (или 40 %).

Требования