IUpdate::CopyFromCache 方法 (wuapi.h)

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

语法

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

参数

[in] path

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

[in] toExtractCabFiles

保留供将来使用。

必须将 设置为ExtractCabFilesVARIANT_TRUEVARIANT_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::CopyFromCacheIUpdate2::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