IUpdate.CancelDownload Method ()

 

Applies To: Windows Server Update Services

Stops downloading the update and its dependencies to the WSUS server.

Namespace:   Microsoft.UpdateServices.Administration
Assembly:  Microsoft.UpdateServices.Administration (in Microsoft.UpdateServices.Administration.dll)

Syntax

void CancelDownload()
void CancelDownload()
abstract CancelDownload : unit -> unit
Sub CancelDownload

Remarks

This method cancels the download only if the state of the update is NotReady.

If more than one update shares a dependency that is downloading, canceling one of the updates will cancel the other updates that share the dependency.

Note that an update can include a download job for each language it supports. Those download jobs that successfully completed before you called CancelDownload are retained; the others are canceled.

To determine if the update is currently downloading, call State. The update is currently downloading if the state is NotReady.

If HostBinariesOnMicrosoftUpdate is true, CancelDownload cancels the downloading of the end-user license agreements.

To restart canceled downloads, call ResumeDownload. To restart all update downloads, call ResumeAllDownloads.

This operation requires WSUS Administrator privileges.

See Also

IUpdate Interface
Microsoft.UpdateServices.Administration Namespace

Return to top