ServiceInstaller.Uninstall(IDictionary) ServiceInstaller.Uninstall(IDictionary) ServiceInstaller.Uninstall(IDictionary) ServiceInstaller.Uninstall(IDictionary) Method

定義

サービスに関する情報をレジストリから削除して、サービスをアンインストールします。Uninstalls the service by removing information about it from the registry.

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)

パラメーター

savedState
IDictionary IDictionary IDictionary IDictionary

インストールに関連付けられているコンテキスト情報を格納する IDictionaryAn IDictionary that contains the context information associated with the installation.

例外

サービス コントロール マネージャーを開くことができませんでした。The Service Control Manager could not be opened.

- または --or-

サービスへのハンドルを取得できませんでした。The system could not get a handle to the service.

注釈

アンインストールを開始する前に、サービスを停止しようとしています。Uninstall first attempts to stop the service before uninstalling it. サービスを停止できない場合、例外はキャッチされず、メソッドはサービスの削除を続行します。If the service cannot be stopped, no exception is caught, and the method continues with the removal of the service.

通常、コードServiceInstaller内でメソッドを呼び出すことはありません。通常は、インストールユーティリティによってのみ呼び出されます。Normally, you will not call the methods on ServiceInstaller within your code; they are generally called only by the install utility. Installutil.exe は、サービスのアンインストールとインストールに使用されます。をアンインストールするには、コマンドライン呼び出しでスイッチを実行します。InstallUtil is used to uninstall services as well as install them; uninstalling takes a switch in the command line call.

アプリケーションのアンインストールルーチンは、プロジェクトインストーラーのInstaller.Contextを使用して、アンインストールするコンポーネントに関する情報を自動的に管理します。An application's uninstall routine maintains information automatically about the components being uninstalled, using the project installer's Installer.Context. このUninstall状態情報savedState は、ServiceInstallerパラメーターとしてに渡され、インスタンスとして継続的に更新され、各インスタンスがユーティリティによってインストールされます。ServiceProcessInstallerThis state information, passed into Uninstall as the savedState parameter, is continuously updated as the ServiceProcessInstaller instance and each ServiceInstaller instance is installed by the utility. 通常、コードでこの状態情報を明示的に変更する必要はありません。It is usually unnecessary for your code to modify this state information explicitly.

Installerクラスから派生するすべてのクラスについて、 Installersコレクションの状態は、メソッドInstallUninstallメソッドで同じである必要があります。For all classes deriving from the Installer class, the state of the Installers collection must be the same in the Install and Uninstall methods. ただし、カスタムインストーラークラスコンストラクターのInstall Installersコレクションにインストーラーインスタンスを追加Uninstallすると、メソッドとメソッドを使用してコレクションのメンテナンスを回避できます。However, you can avoid the maintenance of the collection across the Install and Uninstall methods if you add installer instances to the Installers collection in your custom installer class constructor.

をアンインストールするためのロールバックメカニズムはありません。そのため、1つのサービスのアンインストールに失敗した場合、アンインストールされる他のサービス (通常は同じインストールプロジェクト内) は影響を受けません。There is no rollback mechanism for uninstalling, so if one service fails to uninstall, this does not affect the other services (usually within the same installation project) being uninstalled.

適用対象

こちらもご覧ください