MessageQueueInstaller.Rollback-Methode

Artikel
08/20/2007

Versetzt den Computer durch Rollback der Warteschlangeninformationen, die von der Installationsprozedur in die Registrierung geschrieben wurden, in den Zustand vor der Installation zurück. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.

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

Syntax

'Declaration
Public Overrides Sub Rollback ( _
    savedState As IDictionary _
)
'Usage
Dim instance As MessageQueueInstaller
Dim savedState As IDictionary

instance.Rollback(savedState)

public override void Rollback (
    IDictionary savedState
)

public:
virtual void Rollback (
    IDictionary^ savedState
) override

public void Rollback (
    IDictionary savedState
)

public override function Rollback (
    savedState : IDictionary
)

Parameter

savedState
Ein IDictionary, das den Zustand des Computers vor der Installation enthält.

Hinweise

Die Rollback-Methode macht die Auswirkungen der Install-Methode rückgängig. Rollback wird aufgerufen, wenn die Installation einer Komponente des Installationsprojekts fehlschlägt. Die Install-Methode erstellt die Eigenschaften einer Warteschlange oder legt diese fest. Rollback löscht entweder die Warteschlange oder setzt die Eigenschaften einer bereits vorhandenen Warteschlange auf die Werte vor der Installation zurück.

Normalerweise rufen Sie die Methoden des MessageQueueInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsprogramm InstallUtil.exe aufgerufen. Das Dienstprogramm ruft nach einem Fehler bei der Installation automatisch die Rollback-Methode auf, um alle vom Installationsprozess bereits durchgeführten Änderungen rückgängig zu machen.

Die Installationsroutine einer Anwendung verwendet den Installer.Context des Projektinstallationsprogramms für die automatische Verwaltung von Informationen über bereits installierte Komponenten. Während das Installationsprogramm ein Rollback für die einzelnen MessageQueueInstaller-Instanzen durchführt, werden diese Zustandsinformationen, die als savedState-Parameter an Rollback übergeben werden, fortlaufend aktualisiert. Normalerweise müssen diese Zustandsinformationen vom Code nicht explizit geändert werden.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MessageQueueInstaller-Klasse
MessageQueueInstaller-Member
System.Messaging-Namespace
Commit
Install
Uninstall
IDictionary

Freigeben über