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 错误代码。
此方法还可以返回以下错误代码。
返回代码 | 说明 |
---|---|
|
无法从远程计算机调用此方法。 |
|
参数值无效。 |
|
计算机无法访问更新站点。
(如果实现接口的对象已被锁定,此方法将返回 WU_E_INVALID_OPERATION 。) |
|
不接受 Microsoft 软件许可条款。 |
|
不会下载文件。 |
|
文件哈希验证失败。 |
|
找不到文件或目录。 |
|
找不到文件或目录。 |
注解
若要复制捆绑更新,请对此更新中捆绑的单个更新调用此方法。
注意 不建议或不支持使用 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 |