Rollback Method
Collapse the table of content
Expand the table of content

EventLogInstaller::Rollback Method (IDictionary^)

 

Restores the computer to the state it was in before the installation by rolling back the event log information that the installation procedure wrote to the registry.

Namespace:   System.Diagnostics
Assembly:  System.Configuration.Install (in System.Configuration.Install.dll)

public:
virtual void Rollback(
	IDictionary^ savedState
) override

Parameters

savedState
Type: System.Collections::IDictionary^

An IDictionary that contains the pre-installation state of the computer.

The Rollback method undoes the effects of the Install method. Rollback is called if the installation of any component in the installation project fails. The Install method creates or sets the properties for an event log and event source. Rollback either deletes the event log and source or resets the properties of a pre-existing source to its pre-installation values.

Typically, you do not call the methods of the EventLogInstaller from within your code; they are generally called only by the Installutil.exe (Installer Tool). The tool calls the Rollback method, when this or another component has failed to install, to undo any changes that the installation process has already made.

An application's install routine uses the project installer's Installer::Context property to automatically maintain information about the components that have already been installed. This state information, which is passed to Rollback as the savedState parameter, is continuously updated as the tool rolls back each EventLogInstaller. Usually, it is not necessary for your code to explicitly modify this state information.

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft