Freigeben über


RemoveExistingProducts-Aktion

Die RemoveExistingProducts-Aktion durchläuft die in der Spalte "ActionProperty" der Upgrade-Tabelle aufgeführten Produktcodes und entfernt die Produkte in Sequenz, indem sie gleichzeitige Installationen aufrufen. Für jede gleichzeitige Installation legt das Installationsprogramm die ProductCode- eigenschaft auf den Produktcode fest und legt die REMOVE-Eigenschaft auf den Wert im Feld "Entfernen" der Upgrade-Tabelle fest. Wenn das Feld "Entfernen" leer ist, wird der Standardwert auf ALL festgelegt, und das Installationsprogramm entfernt das gesamte Produkt.

Das Installationsprogramm führt nur die RemoveExistingProducts-Aktion aus, wenn sie ein Produkt zum ersten Mal installiert. Die Aktion wird während einer Wartungsinstallation oder Deinstallation nicht ausgeführt.

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 Aktionen, die Ausführungsskript generieren.
  • Zwischen der InstallExecute-Aktionoder der InstallExecuteAgain-Aktionund der InstallFinalize-Aktion. Im Allgemeinen werden die letzten drei Aktionen direkt nacheinander geplant: InstallExecute, RemoveExistingProducts und InstallFinalize. In diesem Fall werden die aktualisierten Dateien zuerst installiert und dann die alten Dateien entfernt. Wenn das Entfernen der alten Anwendung jedoch fehlschlägt, setzt das Installationsprogramm sowohl das Entfernen der alten Anwendung als auch die Installation der neuen Anwendung zurück.
  • Nach der InstallFinalize-Aktion. Dies ist die effizienteste Platzierung für die Aktion. In diesem Fall aktualisiert das Installationsprogramm Dateien, bevor die alten Anwendungen entfernt werden. Nur die aktualisierten Dateien werden während der Installation installiert. Wenn das Entfernen der alten Anwendung fehlschlägt, setzt das Installationsprogramm nur das Deinstallationsprogramm der alten Anwendung zurück.

ActionData-Nachrichten

Feld Beschreibung der Aktionsdaten
[1] Produkt entfernt.

 

Bemerkungen

Windows Installer legt den UPGRADEPRODUCTCODE-Eigenschaft fest, wenn diese Aktion ausgeführt wird.