Partager via


MessageQueueInstaller.Rollback(IDictionary) Méthode

Définition

Rétablit l'état qui était celui de l'ordinateur avant l'installation, en restaurant les informations de la file d'attente écrites dans le Registre par la procédure d'installation. Cette méthode est prévue pour être utilisée par des outils d'installation qui appellent automatiquement les méthodes appropriées.

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)

Paramètres

savedState
IDictionary

IDictionary qui contient l'état de l'ordinateur avant l'installation.

Remarques

La Rollback méthode annule les effets de la Install méthode . Rollback est appelé si l’installation d’un composant dans le projet d’installation échoue. La Install méthode crée ou définit les propriétés d’une file d’attente. Rollback supprime la file d’attente ou réinitialise les propriétés d’une file d’attente préexistante à leurs valeurs de pré-installation.

En règle générale, vous n’appelez pas les méthodes du MessageQueueInstaller à partir de votre code ; elles sont généralement appelées uniquement par l’utilitaire d’installation InstallUtil.exe. L’utilitaire appelle automatiquement la Rollback méthode après un échec d’installation pour annuler les modifications que le processus d’installation a déjà apportées.

La routine d’installation d’une application utilise le programme d’installation du Installer.Context projet pour gérer automatiquement les informations sur les composants qui ont déjà été installés. Ces informations d’état, qui sont transmises à Rollback en tant que savedState paramètre, sont continuellement mises à jour à mesure que l’utilitaire restaure chaque MessageQueueInstaller instance. En règle générale, il n’est pas nécessaire que votre code modifie explicitement ces informations d’état.

S’applique à

Voir aussi