RemoveExistingProducts-Aktion

Die RemoveExistingProducts-Aktion durchläuft die in der ActionProperty-Spalte der Upgrade-Tabelle aufgeführten Produktcodes und entfernt die Produkte nacheinander, indem gleichzeitige Installationen aufgerufen werden. Für jede gleichzeitige Installation legt das Installationsprogramm die ProductCode-Eigenschaft auf den Produktcode fest und legt die REMOVE-Eigenschaft auf den Wert im Remove-Feld der Upgrade-Tabelle fest. Wenn das Remove-Feld leer ist, wird standardmäßig der Wert standardmäßig ALL verwendet und das Installationsprogramm entfernt das gesamte Produkt.

Das Installationsprogramm führt die RemoveExistingProducts-Aktion nur bei der ersten Installation eines Produkts aus. Es führt die Aktion nicht während einer Wartungsinstallation oder Deinstallation aus.

Sequenzeinschränkungen

Die RemoveExistingProducts-Aktion muss in der Aktionssequenz an einem der folgenden Speicherorte geplant werden.

• Zwischen der InstallValidate-Aktion und der InstallInitialize-Aktion. In diesem Fall entfernt das Installationsprogramm die alten Anwendungen vollständig, bevor die neuen Anwendungen installiert werden. Dies ist eine ineffiziente Platzierung für die Aktion, da alle wiederverwendeten Dateien erneut kopiert werden müssen.
• Nach der InstallInitialize-Aktion und vor allen Aktionen, die ein Ausführungsskript generieren.
• Zwischen der InstallExecute-Aktion, oder der InstallExecuteAgain-Aktion und der InstallFinalize-Aktion. Im Allgemeinen werden die letzten drei Aktionen direkt hintereinander geplant: InstallExecute, RemoveExistingProducts und InstallFinalize. In diesem Fall werden zuerst die aktualisierten Dateien installiert und dann die alten Dateien entfernt. Wenn beim Entfernen der alten Anwendung jedoch ein Fehler auftritt, führt das Installationsprogramm sowohl für das Entfernen der alten Anwendung als auch die Installation der neuen Anwendung ein Rollback aus.
• Nach der InstallFinalize-Aktion. Dies ist die effizienteste Platzierung für die Aktion. In diesem Fall aktualisiert das Installationsprogramm die Dateien, bevor die alten Anwendungen entfernt werden. Nur die zu aktualisierenden Dateien werden während der Installation installiert. Wenn beim Entfernen der alten Anwendung ein Fehler auftritt, führt das Installationsprogramm nur ein Rollback für die Deinstallation der alten Anwendung durch.

ActionData-Meldungen

Feld	Beschreibung der Aktionsdaten
[1]	Entferntes Produkt.

 

Bemerkungen

Windows Installer legt die UPGRADINGPRODUCTCODE-Eigenschaft fest, wenn es diese Aktion ausführt.