IUpdate2：：CopyToCache 方法 (wuapi.h)

  • 项目

将更新的文件从指定的源位置复制到内部 Windows 更新 代理 (WUA) 下载缓存。

语法

HRESULT CopyToCache(
  [in] IStringCollection *pFiles
);

参数

[in] pFiles

一个 IStringCollection 接口，表示包含更新文件的完整路径的字符串集合。

字符串必须提供要复制的文件的完整路径。 字符串不能仅提供包含文件的目录。

返回值

如果成功，则返回 S_OK 。 否则，返回 COM 或 Windows 错误代码。

此方法还可以返回以下错误代码。

返回代码 说明
E_ACCESSDENIED
 无法从远程计算机调用此方法。
E_INVALIDARG
 参数值无效。
WU_E_INVALID_OPERATION
 计算机无法访问更新站点。

注解

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

注意 不建议或不支持使用 IUpdate：：CopyFromCache 和 IUpdate2：：CopyToCache 方法将下载的更新从一台计算机移动到另一台计算机。 当 Windows 更新 代理 (WUA) 下载更新时，它可能只下载特定客户端计算机所需的更新有效负载部分。 更新有效负载的必要部分通常因计算机而异，即使计算机具有类似的硬件和软件配置。 IUpdate2：：CopyToCache 仅当提供的文件与Windows 更新通常在该计算机上下载的文件完全匹配时才有效;如果调用 IUpdate：：CopyFromCache 以获取其他计算机上的文件，则这些文件可能与Windows 更新通常下载的文件不匹配，因此 IUpdate2：：CopyToCache 可能会失败。
 

要求

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

另请参阅

IUpdate2