IUpdateDownloader::Download method (wuapi.h)

Starts a synchronous download of the content files that are associated with the updates.


HRESULT Download(
  [out] IDownloadResult **retval


[out] retval

An IDownloadResult interface that contains result codes for the download.

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
The computer cannot access the update site.
Windows Update Agent (WUA) does not have updates in the collection.
Windows Update Agent is not initialized.


This method returns WU_E_INVALID_OPERATION if the object that is implementing the interface is locked down.

This method returns WU_E_NO_UPDATE if the Updates property of the IUpdateDownloader interface is not set. This method also returns WU_E_NO_UPDATE if the Updates property is set to an empty collection.

This method returns SUS_E_NOT_INITIALIZED if the download job does not contain updates.


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