MessageQueueInstaller.Rollback Method

Restores the computer to the state it was in before the installation, by rolling back the queue information that the installation procedure wrote to the registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

public override void Rollback (
	IDictionary savedState
public void Rollback (
	IDictionary savedState
public override function Rollback (
	savedState : IDictionary



A 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 a queue. Rollback either deletes the queue or resets the properties of a pre-existing queue to their pre-installation values.

Typically, you do not call the methods of the MessageQueueInstaller from within your code; they are generally called only by the InstallUtil.exe installation utility. The utility automatically calls the Rollback method after an installation failure to undo any changes that the installation process has already made.

An application's install routine uses the project installer's Installer.Context 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 utility rolls back each MessageQueueInstaller instance. Usually, it is not necessary for your code to explicitly modify this state information.

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0