ServiceInstaller.Uninstall(IDictionary) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Deinstalliert den Dienst, indem Informationen dazu 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 -> unitPublic Overrides Sub Uninstall (savedState As IDictionary)Parameter
- savedState
- IDictionary
Eine IDictionary , die die Kontextinformationen enthält, die der Installation zugeordnet sind.
Ausnahmen
Der Dienststeuerungs-Manager konnte nicht geöffnet werden.
-oder-
Das System konnte keinen Handle für den Dienst abrufen.
Hinweise
Deinstallieren Sie zuerst versuche, den Dienst zu beenden, bevor Sie ihn deinstallieren. Wenn der Dienst nicht beendet werden kann, wird keine Ausnahme abgefangen, und die Methode wird mit dem Entfernen des Diensts fortgesetzt.
Normalerweise rufen Sie die Methoden ServiceInstaller in Ihrem Code nicht auf. Sie werden in der Regel nur vom Installationshilfsprogramm aufgerufen. InstallUtil wird verwendet, um Dienste zu deinstallieren und sie zu installieren; Bei der Deinstallation wird ein Schalter im Befehlszeilenaufruf ausgeführt.
Die Deinstallationsroutine einer Anwendung verwaltet automatisch Informationen zu den Komponenten, die deinstalliert werden, mithilfe der Projektinstallationsprogramm.Installer.Context Diese Statusinformationen, die als Parameter übergeben Uninstall werden, werden kontinuierlich aktualisiert, während die savedState Instanz und jede ServiceProcessInstaller Instanz vom Dienstprogramm installiert ServiceInstaller wird. Normalerweise ist es nicht erforderlich, dass Ihr Code diese Zustandsinformationen explizit ändert.
Für alle Klassen, die von der Installer Klasse abgeleitet werden, muss der Status der Installers Auflistung in den Install und Uninstall den Methoden identisch sein. Sie können jedoch die Wartung der Auflistung über die Install verschiedenen Methoden Uninstall hinweg vermeiden, wenn Sie der Installers Auflistung im Konstruktor der benutzerdefinierten Installer-Klasse Instanzen 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.
