Export (0) Print
Expand All

ServiceProcessInstaller.Rollback Method

Rolls back service application information written to the registry by the installation procedure. This method is meant to be used by installation tools, which process the appropriate methods automatically.

Namespace:  System.ServiceProcess
Assembly:  System.ServiceProcess (in System.ServiceProcess.dll)

public override void Rollback(
	IDictionary savedState
)

Parameters

savedState
Type: System.Collections.IDictionary

An IDictionary that contains the context information associated with the installation.

ExceptionCondition
ArgumentException

The savedState is null.

-or-

The savedState is corrupted or non-existent.

Normally, you do not call the methods on ServiceProcessInstaller within your code; they are generally called only by the install utility. The install utility automatically calls the ServiceProcessInstaller.Install method during the installation process. It backs out failures, if necessary, by calling Rollback on the object that generated the exception.

An application's install routine maintains information automatically about the components already installed, using the project installer's Installer.Context. This state information, passed into Rollback as the savedState parameter, is continuously updated as the ServiceProcessInstaller instance and each ServiceInstaller instance is installed by the utility. It is usually unnecessary for your code to modify this state information explicitly.

Rollback passes to the calling method any exceptions thrown by base class methods or BeforeInstall / AfterInstall event handlers.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft