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


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

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

Синтаксис

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

Параметры

[in] onProgressChanged

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

[in] onCompleted

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

[in] state

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

[out] retval

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

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

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

коды ошибок.

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

Этот метод вызывается только в том случае, если свойство IsBusy интерфейса IUpdateInstaller возвращает VARIANT_FALSE.

WU_E_NO_UPDATE
клиентский компонент Центра обновления Windows агент (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