次の方法で共有


ServiceProcessInstaller.Rollback メソッド

インストール プロシージャによってレジストリに書き込まれたサービス アプリケーション情報をロールバックします。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に処理します。

Overrides Public Sub Rollback( _
   ByVal savedState As IDictionary _)
[C#]
public override void Rollback(IDictionarysavedState);
[C++]
public: void Rollback(IDictionary* savedState);
[JScript]
public override function Rollback(
   savedState : IDictionary);

パラメータ

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

例外

例外の種類 条件
ArgumentException savedState が null 参照 (Visual Basic では Nothing) です。

または

savedState が、破損しているか存在していません。

解説

通常、コード内の ServiceProcessInstaller ではこのメソッドを呼び出しません。このメソッドを呼び出すのは、一般的にインストール ユーティリティだけです。インストール ユーティリティは、インストール プロセス中に、 ServiceProcessInstaller.Install メソッドを自動的に呼び出します。必要に応じて、例外を生成したオブジェクトで Rollback を呼び出すことによって、エラーを回復します。

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

Rollback は、基本クラスのメソッドによって、または BeforeInstall イベント ハンドラや AfterInstall イベント ハンドラによってスローされた例外を、呼び出す側のメソッドに渡します。

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

ServiceProcessInstaller クラス | ServiceProcessInstaller メンバ | System.ServiceProcess 名前空間 | Install | ComponentInstaller