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

Метод IUpdateInstaller::BeginInstall (wuapi.h)

  • Статья

Запускает асинхронную установку обновлений.

Синтаксис

HRESULT BeginInstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

Параметры

[in] onProgressChanged

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

[in] onCompleted

Интерфейс IInstallationCompletedCallback , который вызывается при завершении операции установки.

[in] state

Состояние, зависящее от вызывающего объекта, возвращаемое свойством AsyncState интерфейса IInstallationJob .

[out] retval

Интерфейс IInstallationJob , содержащий свойства и методы, доступные для инициированной асинхронной операции установки.

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

Этот метод возвращает следующие значения HRESULT и другие com или Windows

коды ошибок.

Код возврата Описание
S_OK
 Асинхронная установка обновления успешно запущена.
WU_E_INSTALL_NOT_ALLOWED
 Этот метод нельзя вызвать, когда установщик устанавливает или удаляет обновление.

Вызывайте этот метод, только если свойство IsBusy интерфейса IUpdateInstaller возвращает VARIANT_FALSE.
WU_E_NO_UPDATE
 Клиентский компонент Центра обновления Windows Agent (WUA) не имеет обновлений в коллекции.

Комментарии

При вызове этого метода из языка сценариев задайте для параметра onProgressChanged идентификатор объекта службы автоматизации с идентификатором диспетчеризации (DSIPID) равным нулю (0), который реализует подпрограмму обратного вызова. Выполните то же самое для параметра onCompleted .

Этот метод возвращает WU_E_NO_UPDATE, если свойство ОбновленияIUpdateInstaller не задано. Этот метод также возвращает WU_E_NO_UPDATE, если свойству Обновления присвоена пустая коллекция.

При использовании любого асинхронного API WUA в приложении может потребоваться реализовать механизм времени ожидания. Дополнительные сведения о выполнении асинхронных операций WUA см. в разделе Рекомендации по асинхронным операциям WUA.

Требования

   
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Целевая платформа Windows
Header wuapi.h
Библиотека Wuguid.lib
DLL Wuapi.dll

См. также раздел

IUpdateInstaller