ServiceInstaller.Uninstall(IDictionary) Methode

Definition

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

public:
 override void Uninstall(System::Collections::IDictionary ^ savedState);
public override void Uninstall (System.Collections.IDictionary savedState);
override this.Uninstall : System.Collections.IDictionary -> unit
Public Overrides Sub Uninstall (savedState As IDictionary)

Parameter

savedState
IDictionary

Ein IDictionary mit Kontextinformationen für die Installation.

Ausnahmen

Der Dienststeuerungs-Manager konnte nicht geöffnet werden.

- oder -

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

Hinweise

Deinstallieren Sie die ersten Versuche, den Dienst zu beenden, bevor Sie ihn deinstallieren. Wenn der Dienst nicht beendet werden kann, wird keine Ausnahme erfasst, und die Methode wird mit dem Entfernen des Diensts fortgesetzt.

Normalerweise rufen Sie die Methoden in Ihrem Code nicht auf. Sie werden in der Regel nur vom ServiceInstaller Installationsprogramm aufgerufen. InstallUtil wird verwendet, um Dienste zu deinstallieren und zu installieren. für die Deinstallation wird ein Schalter im Befehlszeilenaufruf verwendet.

Die Deinstallationsroutine einer Anwendung verwaltet automatisch Informationen zu den komponenten, die deinstalliert werden, indem der des Projektinstallationsprogramms verwendet Installer.Context wird. Diese Zustandsinformationen, die als Parameter an übergeben werden, werden fortlaufend als -Instanz aktualisiert, und jede Instanz Uninstall savedState wird vom ServiceProcessInstaller ServiceInstaller Hilfsprogramm installiert. In der Regel ist es nicht erforderlich, dass Ihr Code diese Zustandsinformationen explizit ändert.

Für alle Klassen, die von der -Klasse ableiten, muss der Zustand der Auflistung in der -Methode und Installer Installers der -Methode identisch Install Uninstall sein. Sie können jedoch die Wartung der Sammlung über die Methoden und hinweg vermeiden, wenn Sie der Auflistung in Ihrem benutzerdefinierten Konstruktor der Installerklasse Install Uninstall Installers Installationsprogramminstanzen hinzufügen.

Es gibt keinen Rollbackmechanismus für die Deinstallation. Wenn also ein Dienst nicht deinstalliert werden kann, wirkt sich dies nicht auf die anderen Dienste (normalerweise innerhalb desselben Installationsprojekts) aus, die deinstalliert werden.

Gilt für

Siehe auch