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

AsyncState 属性 IInstallationJob 接口返回的特定于调用方的状态。

[out] retval

IInstallationJob 接口，其中包含可用于启动的异步卸载操作的属性和方法。

返回值

此方法返回以下 HRESULT 值和其他 COM 或 Windows

错误代码。

返回代码 说明
S_OK
 已成功启动更新的异步删除。
WU_E_INSTALL_NOT_ALLOWED
 当安装程序安装或删除更新时，请勿调用此方法。

仅当 IUpdateInstaller 接口的 IsBusy 属性返回VARIANT_FALSE时，才调用此方法。
WU_E_NO_UPDATE
 Windows 更新 代理 (WUA) 集合中没有更新。

注解

如果从脚本语言调用此方法，请将 onProgressChanged 参数设置为自动化对象的标识符，该对象的调度标识符 (DSIPID) 零 (0) 实现回调例程。 对 onCompleted 参数执行相同操作。

如果未设置 IUpdateInstaller 的 汇报 属性，此方法将返回WU_E_NO_UPDATE。 如果 汇报 属性设置为空集合，则此方法还会返回WU_E_NO_UPDATE。

在应用中使用任何异步 WUA API 时，可能需要实现超时机制。 有关如何执行异步 WUA 操作的详细信息，请参阅 异步 WUA 操作指南。

要求

要求 值
最低受支持的客户端 Windows XP、Windows 2000 Professional 和 SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003、Windows 2000 Server SP3 [仅限桌面应用]
目标平台 Windows
标头 wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

另请参阅

IUpdateInstaller