MessageQueueInstaller.Rollback メソッド

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

MessageQueueInstaller.Rollback メソッド

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

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

Visual Basic (宣言)

Public Overrides Sub Rollback
 ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim instance As MessageQueueInstaller
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。

解説

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

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

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

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
MessageQueueInstaller クラス
MessageQueueInstaller メンバ
System.Messaging 名前空間
Commit
Install
Uninstall
IDictionary