ServiceInstaller.Uninstall メソッド

.NET Framework クラス ライブラリ リファレンス

ServiceInstaller.Uninstall メソッド

サービスに関する情報をレジストリから削除して、サービスをアンインストールします。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Uninstall
 ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim instance As ServiceInstaller
Dim savedState As IDictionary

instance.Uninstall(savedState)

C#

public override void Uninstall (
    IDictionary savedState
)

C++

public:
virtual void Uninstall (
    IDictionary^ savedState
) override

J#

public void Uninstall (
    IDictionary savedState
)

JScript

public override function Uninstall (
    savedState : IDictionary
)

パラメータ

savedState

インストールに関連付けられているコンテキスト情報を格納する IDictionary。

例外

例外の種類	条件
Win32Exception	サービス コントロール マネージャを開くことができませんでした。 または サービスへのハンドルを取得できませんでした。

解説

アンインストールでは、アンインストールを実行する前にサービスを停止しようとします。サービスが停止できない場合も、例外はキャッチされず、メソッドはサービスの削除を続行します。

通常、コード内の ServiceInstaller では、これらのメソッドを呼び出しません。これらのメソッドを呼び出すのは、一般にはインストール ユーティリティだけです。InstallUtil は、サービスのインストールとアンインストールに使用されます。アンインストールするには、コマンド ラインの呼び出しを切り替えます。

アプリケーションのアンインストール ルーチンは、アンインストールされているコンポーネントに関する情報をプロジェクト インストーラの Installer.Context を使用して自動的に維持します。この状態情報は、Uninstall に savedState パラメータとして渡され、ServiceProcessInstaller インスタンスとして継続的に更新されます。各 ServiceInstaller インスタンスは、ユーティリティでインストールされます。通常、コードではこの状態情報を明示的に変更する必要はありません。

Installer クラスから派生するクラスの場合、Installers コレクションの状態は、Install および Uninstall メソッド内と同じである必要があります。ただし、インスタンスをカスタム インストーラ クラス コンストラクタ内の Installers コレクションに追加した場合は、コレクションを Install メソッドおよび Uninstall メソッド間で保持する必要はありません。

アンインストールにはロールバックする機構がないため、1 つのサービスがアンインストールに失敗しても、アンインストール中の他のサービス (通常は同じインストール プロジェクト内) は影響を受けません。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceInstaller クラス
ServiceInstaller メンバ
System.ServiceProcess 名前空間
Install