通过

IUpdateInstaller：：BeginInstall 方法 （wuapi.h）

启动更新的异步安装。

Syntax

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

错误代码。

返回代码 Description
S_OK
 更新的异步安装已成功启动。
WU_E_INSTALL_NOT_ALLOWED
 安装或删除更新时，无法调用此方法。

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

注解

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

如果未设置 IUpdateInstaller 的 Updates 属性，此方法将返回WU_E_NO_UPDATE。 如果 Updates 属性设置为空集合，此方法也会返回WU_E_NO_UPDATE。

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

要求

Requirement 价值
最低支持的客户端 具有 SP3 的 Windows XP、Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows Server 2003、带 SP3 的 Windows 2000 Server [仅限桌面应用]
目标平台 Windows操作系统
Header wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

另请参阅

IUpdateInstaller

  • Last updated on