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

Метод 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.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)
DLL Shobjidl.idl