NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Installer.Rollback

Restores the machine to the state it was in before the Install method was called.

[Visual Basic]
Overridable Public Sub Rollback( _
   ByVal savedState As IDictionary _
)
[C#]
public virtual void Rollback(
   IDictionary savedState
);
[C++]
public: virtual void Rollback(
   IDictionary* savedState
);
[JScript]
public function Rollback(
   savedState : IDictionary
);

Parameters

savedState
A IDictionary representing the state of the installation that was saved by the Install method.

Exceptions

Exception Type Condition
ArgumentException The savedState parameter is null.

-or-

The saved state IDictionary may have been corrupted.

Remarks

Rollback is called to restore the machine to the state it was in before the Install method was called. This method will be called if the Install method of any installer in this instance's InstallerCollection fails to run correctly. Rollback will also be called if the Install method on this instance fails, so it must be able to handle a failed install. Any exceptions generated by calling the Rollback methods of the installers in the collection will be ignored and the rollback of other installers will continue.

Notes to Inheritors: If you override the Rollback method in a derived class, be sure to call the base class's Rollback method.

See Also

Installer Class | Installer Members | System.Configuration.Install Namespace | Commit | Uninstall | Install | InstallerCollection | Installers