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

Обновления ход выполнения действия в пользовательский интерфейс.

Синтаксис

HRESULT UpdateProgress(
  [in] ULONGLONG ulCompleted,
  [in] ULONGLONG ulTotal
);

Параметры

[in] ulCompleted

Тип: ULONGLONG

Объем завершенного действия.

[in] ulTotal

Тип: ULONGLONG

Общий объем действия.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае.

Комментарии

Этот метод следует периодически вызывать для обновления хода выполнения действия. Реализующий класс может интерпретировать эти значения любым нужным способом, хотя значения ulCompleted и ulTotal должны интерпретироваться относительно друг друга для определения значимого значения хода выполнения. Часто требуется процент, в этом случае значение ulCompleted должно быть разделено на ulTotal, а результат умножен на значение 100.

Требования