IUpdate：：CopyFromCache 方法 (wuapi.h)

  • 项目

将更新的内容复制到指定路径。

语法

HRESULT CopyFromCache(
  [in] BSTR         path,
  [in] VARIANT_BOOL toExtractCabFiles
);

参数

[in] path

要复制更新内容的位置的路径。

[in] toExtractCabFiles

保留供将来使用。

必须将 设置为ExtractCabFiles 以 VARIANT_TRUE 或 VARIANT_FALSE。

返回值

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

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

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

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

WU_E_EULAS_DECLINED
 不接受 Microsoft 软件许可条款。
WU_E_DM_NOTDOWNLOADED
 不会下载文件。
WU_E_DM_INCORRECTFILEHASH
 文件哈希验证失败。
COR_E_DIRECTORYNOTFOUND
 找不到文件或目录。
STG_E_PATHNOTFOUND
 找不到文件或目录。

注解

若要复制捆绑更新，请对此更新中捆绑的单个更新调用此方法。

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

另请参阅

IUpdate