IUpdate.Decline()

Declines the update for deployment.

public void Decline();
Public Sub Decline()
Implements IUpdate.Decline

Parameters

This method has no parameters.

Return Value

This method does not return a value.

Exceptions

Exception type Condition
WsusObjectNotFoundException Cannot find the update to decline.
System.InvalidOperationException You cannot decline the update if the server is a replica WSUS server (if IUpdateServerConfiguration.IsReplicaServer is true).

Remarks

If the update is currently approved, this method removes the approval from the update. To determine if an update is declined, call IUpdate.IsDeclined. Declining the update does not affect clients that have already received the approved update. If this is an issue, you may need to approve the update again using a different action. For example, if you approved an update to be installed on the clients and later declined the update, you should change the approval action to uninstall to remove the update from the clients.

Declining an update removes all approvals for all revisions of the update.

A bundled update represents multiple child updates. The children may be explicitly or implicitly deployable. Declining a bundled update also declines its children.

Requirements

Server Requires Windows Server 2003 or Windows 2000 Server SP4 and later.
Namespace

Defined in Microsoft.UpdateServices.Administration.

Assembly

Requires Microsoft.UpdateServices.Administration (in Microsoft.UpdateServices.Administration.dll).

.NET Framework

Requires .NET Framework 1.1.