Share via


MessageQueueInstaller.Rollback(IDictionary) メソッド

定義

インストール プロシージャによってレジストリに書き込まれたキュー情報をロールバックして、コンピューターをインストール前の状態に復元します。 このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。

public:
 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)

パラメーター

savedState
IDictionary

インストール前のコンピューターの状態を格納している IDictionary

注釈

メソッドは Rollback 、 メソッドの効果を元に Install 戻します。 Rollback は、インストール プロジェクト内のコンポーネントのインストールが失敗した場合に呼び出されます。 メソッドは Install 、キューのプロパティを作成または設定します。 Rollback キューを削除するか、既存のキューのプロパティをインストール前の値にリセットします。

通常、コード内から の MessageQueueInstaller メソッドは呼び出しません。通常は、InstallUtil.exe インストール ユーティリティによってのみ呼び出されます。 ユーティリティは、インストールに失敗した後に Rollback メソッドを自動的に呼び出して、インストール プロセスが既に行った変更を元に戻します。

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

適用対象

こちらもご覧ください