IUpdateDownloaderEx::D ownload2 方法 (wuapi.h)

重要

某些信息与预发行产品有关,该产品在商业发布之前可能会进行大幅修改。 Microsoft对此处提供的信息不作任何明示或暗示的保证。

启动与更新关联的内容文件的同步下载。

语法

HRESULT Download2(
  DownloadType    downloadType,
  IDownloadResult **retval
);

参数

downloadType

DownloadType 中的值 指定要执行的下载类型、完整下载或仅下载更新引导程序。

注意

尝试下载不包含更新的更新引导程序将失败,错误代码WU_E_NOT_SUPPORTED。

retval

IDownloadResult 接口,其中包含下载的结果代码。

返回值

HRESULT 包括以下值之一:

价值 描述
S_OK 成功。
WU_E_INVALID_OPERATION 计算机无法访问更新站点。
WU_E_NO_UPDATE Windows 更新代理(WUA)在集合中没有更新。
WU_E_NOT_INITIALIZED 未初始化 Windows 更新代理(WUA)。
WU_E_NOT_SUPPORTED 在不包含更新的更新上尝试了更新引导程序下载。

言论

如果实现接口的对象被锁定,此方法将返回 WU_E_INVALID_OPERATION

如果未设置 IUpdateDownloader 接口的 Updates 属性,此方法将返回 WU_E_NO_UPDATE。 如果 Updates 属性设置为空集合,此方法也会返回 WU_E_NO_UPDATE

如果下载作业不包含更新,此方法将返回 SUS_E_NOT_INITIALIZED

要求

要求 价值
最低支持的客户端 Windows 11 内部版本 26100
标头 wuapi.h