ServiceInstaller.Uninstall-Methode

Artikel
08/20/2007

Deinstalliert den Dienst, indem die entsprechenden Daten aus der Registrierung entfernt werden.

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

Syntax

'Declaration
Public Overrides Sub Uninstall ( _
    savedState As IDictionary _
)
'Usage
Dim instance As ServiceInstaller
Dim savedState As IDictionary

instance.Uninstall(savedState)

public override void Uninstall (
    IDictionary savedState
)

public:
virtual void Uninstall (
    IDictionary^ savedState
) override

public void Uninstall (
    IDictionary savedState
)

public override function Uninstall (
    savedState : IDictionary
)

Parameter

savedState
Ein IDictionary mit Kontextinformationen für die Installation.

Ausnahmen

Ausnahmetyp	Bedingung
Win32Exception	Der Dienststeuerungs-Manager konnte nicht geöffnet werden. - oder - Das System konnte kein Handle für den Dienst abrufen.

Win32Exception

Der Dienststeuerungs-Manager konnte nicht geöffnet werden.

- oder -

Das System konnte kein Handle für den Dienst abrufen.

Hinweise

Das Deinstallationsprogramm versucht zuerst, den Dienst zu beenden, bevor es ihn deinstalliert. Wenn der Dienst nicht beendet werden kann, werden keine Ausnahmen abgefangen, und die Methode fährt mit dem Entfernen des Dienstes fort.

Normalerweise rufen Sie die Methoden für ServiceInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsdienstprogramm aufgerufen. InstallUtil wird sowohl zur Deinstallation als auch zur Installation von Diensten verwendet. Zum Deinstallieren wird ein entsprechender Schalter beim Befehlszeilenaufruf verwendet.

Die Deinstallationsroutine einer Anwendung verwaltet automatisch Informationen über bereits deinstallierte Komponenten. Dazu wird der Installer.Context des Projektinstallationsprogramms verwendet. Diese Zustandsinformationen, die als savedState-Parameter an Uninstall übergeben werden, werden fortlaufend aktualisiert, während das Dienstprogramm die ServiceProcessInstaller-Instanz und alle ServiceInstaller-Instanzen installiert. Normalerweise ist es nicht erforderlich, dass der Code diese Zustandsinformationen explizit ändert.

Für alle von der Installer-Klasse abgeleiteten Klassen muss der Zustand der Installers-Auflistung in der Install-Methode und in der Uninstall-Methode übereinstimmen. Sie können es jedoch vermeiden, die Auflistung in der Install-Methode und in der Uninstall-Methode in Übereinstimmung halten zu müssen, indem Sie der Installers-Auflistung im Klassenkonstruktor für das benutzerdefinierte Installationsprogramm Instanzen des Installationsprogramms hinzufügen.

Für die Deinstallation steht kein Rollback zur Verfügung. Wenn beim Deinstallieren eines Dienstes ein Fehler auftritt, wirkt sich dies nicht auf die Deinstallation der anderen Dienste aus, die sich i. d. R. in demselben Installationsprojekt befinden.

.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 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

ServiceInstaller-Klasse
ServiceInstaller-Member
System.ServiceProcess-Namespace
Install

Freigeben über