ServiceProcessInstaller.Rollback メソッド

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

ServiceProcessInstaller.Rollback メソッド

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

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

Visual Basic (宣言)

Public Overrides Sub Rollback
 ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim instance As ServiceProcessInstaller
Dim savedState As IDictionary

instance.Rollback(savedState)

C#

public override void Rollback (
    IDictionary savedState
)

C++

public:
virtual void Rollback (
    IDictionary^ savedState
) override

J#

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 を使用して自動的に維持します。この状態情報は、Rollback に savedState パラメータとして渡され、ServiceProcessInstaller インスタンスとして継続的に更新されます。各 ServiceInstaller インスタンスは、ユーティリティでインストールされます。通常、コードではこの状態情報を明示的に変更する必要はありません。

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

.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

参照

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