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

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

  • Статья

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

Синтаксис

HRESULT UpdateProgress(
  [in] ULONGLONG ullSizeCurrent,
  [in] ULONGLONG ullSizeTotal,
  [in] int       nFilesCurrent,
  [in] int       nFilesTotal,
  [in] int       nFoldersCurrent,
  [in] int       nFoldersTotal
);

Параметры

[in] ullSizeCurrent

Тип: ULONGLONGLONG

Количество байтов, обработанных в текущей операции.

[in] ullSizeTotal

Тип: ULONGLONGLONG

Общее количество байтов в текущей операции.

[in] nFilesCurrent

Тип: int

Количество файлов, обработанных в текущей операции.

[in] nFilesTotal

Тип: int

Общее количество файлов в операции. Задайте значение 0, чтобы указать, что значение не изменилось с момента последнего вызова этого метода.

[in] nFoldersCurrent

Тип: int

Количество папок, обработанных в текущей операции.

[in] nFoldersTotal

Тип: int

Общее количество папок в операции. Задайте значение 0, чтобы указать, что значение не изменилось с момента последнего вызова этого метода.

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

Тип: HRESULT

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

Комментарии

Задайте для ullSizeTotal, nFilesTotal и nFoldersTotal значение 0, чтобы указать, что итоги не изменились с момента последнего вызова этого метода.

Задайте для всех шести параметров значение 0, чтобы указать, что ход выполнения не изменился с момента последнего вызова этого метода.

Примечание для разработчиков

Реализующие эту функцию должны возвращать код ошибки, когда операция должна завершиться до ее завершения, например, когда пользователь нажимает кнопку Отмена .

Требования

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