ServiceProcessInstaller.Rollback(IDictionary) メソッド


インストール プロシージャによってレジストリに書き込まれたサービス アプリケーション情報をロールバックします。Rolls back service application information written to the registry by the installation procedure. このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に処理します。This method is meant to be used by installation tools, which process the appropriate methods automatically.

 override void Rollback(System::Collections::IDictionary ^ savedState);
public override void Rollback (System.Collections.IDictionary savedState);
override this.Rollback : System.Collections.IDictionary -> unit
Public Overrides Sub Rollback (savedState As IDictionary)



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


savedStatenull です。The savedState is null.

- または --or- savedState が、破損しているか存在していません。The savedState is corrupted or non-existent.


通常、コード内でメソッドを呼び出さないでください ServiceProcessInstaller 。通常は、インストールユーティリティによってのみ呼び出されます。Normally, you do not call the methods on ServiceProcessInstaller within your code; they are generally called only by the install utility. インストールユーティリティでは、インストールプロセス中にメソッドが自動的に呼び出され ServiceProcessInstaller.Install ます。The install utility automatically calls the ServiceProcessInstaller.Install method during the installation process. 必要に応じて、例外を生成したオブジェクトに対してを呼び出すことによって、エラーをバックアップ Rollback します。It backs out failures, if necessary, by calling Rollback on the object that generated the exception.

アプリケーションのインストールルーチンは、プロジェクトインストーラーのを使用して、既にインストールされているコンポーネントに関する情報を自動的に管理し Installer.Context ます。An application's install routine maintains information automatically about the components already installed, using the project installer's Installer.Context. この状態情報 Rollback は、パラメーターとしてに渡され、インスタンスとして継続的に更新され、 savedState ServiceProcessInstallerServiceInstaller インスタンスがユーティリティによってインストールされます。This state information, passed into Rollback 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.

Rollback基底クラスのメソッドまたはイベントハンドラーによってスローされた例外を呼び出し元のメソッドに渡し BeforeInstall / AfterInstall ます。Rollback passes to the calling method any exceptions thrown by base class methods or BeforeInstall / AfterInstall event handlers.