EventLogInstaller.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 。

解説

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

インストールによって、既存のイベント ソースが削除され、同じ名前の新しいソースが作成された場合、前回のソースとそのログ登録が復元されます。

通常、コードからは EventLogInstaller のメソッドを呼び出しません。このメソッドを呼び出すのは、一般的にインストール ユーティリティの InstallUtil.exe だけです。ユーティリティは、インストール時にこのコンポーネントまたは別のコンポーネントをインストールできなかった場合に Rollback メソッドを呼び出して、インストール処理が既に加えた変更を元に戻します。

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

必要条件

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

.NET Framework セキュリティ:

• 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

EventLogInstaller クラス | EventLogInstaller メンバ | System.Diagnostics 名前空間 | Install | Uninstall | IDictionary