EventLogInstaller.Rollback(IDictionary) Metoda

Definicja

Przywraca komputer do stanu sprzed instalacji przez wycofanie informacji dziennika zdarzeń, że procedura instalacji zapisała w rejestrze.Restores the computer to the state it was in before the installation by rolling back the event log information that the installation procedure wrote to the registry.

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)

Parametry

savedState
IDictionary

IDictionaryZawiera stan sprzed instalacji komputera.An IDictionary that contains the pre-installation state of the computer.

Uwagi

RollbackMetoda unwykonuje skutki Install metody.The Rollback method undoes the effects of the Install method. Rollback jest wywoływana, jeśli instalacja któregokolwiek składnika w projekcie instalacji zakończy się niepowodzeniem.Rollback is called if the installation of any component in the installation project fails. InstallMetoda tworzy lub ustawia właściwości dziennika zdarzeń i źródła zdarzeń.The Install method creates or sets the properties for an event log and event source. Rollback usuwa dziennik zdarzeń i źródło lub resetuje właściwości istniejącego źródła do jego wartości sprzed instalacji.Rollback either deletes the event log and source or resets the properties of a pre-existing source to its pre-installation values.

Zazwyczaj nie są wywoływane metody EventLogInstaller z poziomu kodu; są one zwykle wywoływane tylko przez Installutil.exe (Narzędzie instalatora).Typically, you do not call the methods of the EventLogInstaller from within your code; they are generally called only by the Installutil.exe (Installer Tool). Narzędzie wywołuje Rollback metodę, gdy nie można zainstalować tego lub innego składnika, aby cofnąć zmiany wprowadzone przez proces instalacji.The tool calls the Rollback method, when this or another component has failed to install, to undo any changes that the installation process has already made.

Procedura instalacji aplikacji używa właściwości Instalatora projektu Installer.Context do automatycznego przechowywania informacji o składnikach, które zostały już zainstalowane.An application's install routine uses the project installer's Installer.Context property to automatically maintain information about the components that have already been installed. Informacje o stanie, które są przenoszone do Rollback jako savedState parametr, są stale aktualizowane, ponieważ narzędzie wycofuje każdy z nich EventLogInstaller .This state information, which is passed to Rollback as the savedState parameter, is continuously updated as the tool rolls back each EventLogInstaller. Zwykle nie jest konieczne, aby kod jawnie modyfikował te informacje o stanie.Usually, it is not necessary for your code to explicitly modify this state information.

Dotyczy

Zobacz też