Метод 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
коды ошибок.
Код возврата | Описание |
---|---|
|
Асинхронное удаление обновления запущено успешно. |
|
Не вызывайте этот метод, если установщик устанавливает или удаляет обновление.
Этот метод вызывается только в том случае, если свойство IsBusy интерфейса IUpdateInstaller возвращает VARIANT_FALSE. |
|
клиентский компонент Центра обновления 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 |