IUpdate2::CopyToCache 方法 (wuapi.h)
將指定來源位置的更新檔案複製到內部 Windows Update Agent (WUA) 下載快取。
語法
HRESULT CopyToCache(
[in] IStringCollection *pFiles
);
參數
[in] pFiles
IStringCollection 介面,表示包含更新檔案完整路徑的字串集合。
字串必須提供所複製檔案的完整路徑。 字串不能只提供包含檔案的目錄。
傳回值
如果成功 , 則傳回S_OK。 否則,傳回 COM 或 Windows 錯誤碼。
此方法也可以傳回下列錯誤碼。
傳回碼 | Description |
---|---|
|
這個方法無法從遠端電腦呼叫。 |
|
參數值無效。 |
|
計算機無法存取更新網站。 |
備註
如果實作介面的對象已鎖定,這個方法會傳回 WU_E_INVALID_OPERATION 。
注意 我們不建議或支援使用 IUpdate::CopyFromCache 和 IUpdate2::CopyToCache 方法,將下載的更新從一部計算機移至另一部計算機。 當 Windows Update Agent (WUA) 下載更新時,它可能只會下載特定客戶端電腦所需的更新承載部分。 更新承載的必要部分通常可能會從一部計算機到另一部計算機而有所不同,即使計算機具有類似的硬體和軟體設定也一樣。 IUpdate2::CopyToCache 只有在提供的檔案與 Windows Update 的檔案完全相符時才會正常運作;如果您呼叫 IUpdate::CopyFromCache 來取得不同計算機上的檔案,則檔案可能不符合 Windows Update 的檔案,因此 IUpdate2::CopyToCache 可能會失敗。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wuapi.h |
程式庫 | Wuguid.lib |
Dll | Wuapi.dll |