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

Коды ошибок.

Код возврата Description
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, если свойство UpdatesIUpdateInstaller не задано. Этот метод также возвращает WU_E_NO_UPDATE, если для свойства Updates задана пустая коллекция.

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

Требования

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

См. также

IUpdateInstaller