Edit

IUpdate::CopyFromCache method (wuapi.h)

  • Article

Copies the contents of an update to a specified path.

Syntax

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

Parameters

[in] path

The path of the location where the update contents are to be copied.

[in] toExtractCabFiles

Reserved for future use.

You must set toExtractCabFiles to VARIANT_TRUE or VARIANT_FALSE.

Return value

Returns S_OK if successful. Otherwise, returns a COM or Windows error code.

This method can also return the following error codes.

Return code Description
E_ACCESSDENIED
 This method cannot be called from a remote computer.
E_INVALIDARG
 A parameter value is invalid.
WU_E_INVALID_OPERATION
 The computer could not access the update site.

(This method returns WU_E_INVALID_OPERATION if the object that is implementing the interface has been locked down.)
WU_E_EULAS_DECLINED
 The Microsoft Software License Terms are not accepted.
WU_E_DM_NOTDOWNLOADED
 The files are not downloaded.
WU_E_DM_INCORRECTFILEHASH
 The file hash verification failed.
COR_E_DIRECTORYNOTFOUND
 A file or directory could not be located.
STG_E_PATHNOTFOUND
 A file or directory could not be located.

Remarks

To copy bundled updates, call this method on the individual updates that are bundled in this update.

Note  We don't recommend or support the use of the IUpdate::CopyFromCache and IUpdate2::CopyToCache methods to move downloaded updates from one computer to another computer. When the Windows Update Agent (WUA) downloads an update, it might only download the portions of the update’s payload that are necessary for a particular client computer. The necessary portions of the update’s payload can often vary from one computer to another computer, even if the computers have similar hardware and software configurations. IUpdate2::CopyToCache only works if the provided files are an exact match for the files that Windows Update would have normally downloaded on that computer; if you called IUpdate::CopyFromCache to obtain the files on a different computer, the files are likely not to match the files that Windows Update would have normally downloaded so IUpdate2::CopyToCache might fail.
 

Requirements

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional with SP3 [desktop apps only]
Minimum supported server Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]
Target Platform Windows
Header wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

See also

IUpdate