EventLogInstaller.Rollback(IDictionary) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
インストール手順でレジストリに書き込まれたイベント ログ情報をロールバックして、コンピューターをインストール前の状態に復元します。
public:
override void Rollback(System::Collections::IDictionary ^ savedState);public override void Rollback(System.Collections.IDictionary savedState);override this.Rollback : System.Collections.IDictionary -> unitPublic Overrides Sub Rollback (savedState As IDictionary)パラメーター
- savedState
- IDictionary
コンピューターのプレインストール状態を含む IDictionary 。
注釈
Rollback メソッドは、Install メソッドの効果を元に戻します。 Rollback は、インストール プロジェクト内のコンポーネントのインストールが失敗した場合に呼び出されます。 Install メソッドは、イベント ログとイベント ソースのプロパティを作成または設定します。 Rollback イベント ログとソースを削除するか、既存のソースのプロパティをインストール前の値にリセットします。
通常、 EventLogInstaller のメソッドはコード内から呼び出しません。通常、 Installutil.exe (インストーラー ツール) によってのみ呼び出されます。 このツールは、 Rollback メソッドを呼び出します。このコンポーネントまたは別のコンポーネントがインストールに失敗した場合は、インストール プロセスが既に行った変更を元に戻します。
アプリケーションのインストール ルーチンは、プロジェクト インストーラーの Installer.Context プロパティを使用して、既にインストールされているコンポーネントに関する情報を自動的に保持します。 この状態情報は、Rollback パラメーターとしてsavedStateに渡され、ツールが各EventLogInstallerをロールバックすると継続的に更新されます。 通常、コードでこの状態情報を明示的に変更する必要はありません。
