通过

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

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

[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 (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