Aktion "FindRelatedProducts"

Die Aktion FindRelatedProducts durchläuft jeden Datensatz der Upgradetabelle nacheinander und vergleicht den Upgradecode, die Produktversion und die Sprache in jeder Zeile mit produkten, die auf dem System installiert sind. Wenn FindRelatedProducts eine Entsprechung zwischen den Upgradeinformationen und einem installierten Produkt erkennt, wird der Produktcode an die Eigenschaft angefügt, die in der Spalte ActionProperty der UpgradeTable angegeben ist.

Die Aktion FindRelatedProducts wird nur bei der ersten Installation des Produkts ausgeführt. Die Aktion FindRelatedProducts wird nicht während des Wartungsmodus oder der Deinstallation ausgeführt.

Abgefragte Datenbanktabellen

Diese Aktion fragt die folgende Tabelle ab:

Upgradetabelle

Verwendete Eigenschaften

Die Aktion FindRelatedProducts verwendet die UpgradeCode-Eigenschaft und die Versions- und Sprachinformationen, die in der Upgradetabelle erfasst wurden, um installierte Produkte zu erkennen, die vom ausstehenden Upgrade betroffen sind. Er fügt den Produktcode der erkannten Produkte an die -Eigenschaft in der ActionProperty -Spalte der UpgradeTable an.

FindRelatedProducts erkennt nur vorhandene Produkte, die mit dem Windows Installer installiert wurden, mit einem .msi, der eine UpgradeCode-Eigenschaft, eine ProductVersion-Eigenschaft und einen Wert für die ProductLanguage-Eigenschaft definiert, die eine der in der Eigenschaft "Vorlagenzusammenfassung" aufgeführten Sprachen ist.

Beachten Sie, dass FindRelatedProducts die von MsiGetProductInfo zurückgegebene Sprache verwendet. Damit FindRelatedProducts ordnungsgemäß funktioniert, muss der Paketautor sicherstellen, dass die ProductLanguage-Eigenschaft in der Property -Tabelle auf eine Sprache festgelegt ist, die auch in der Eigenschaft für die Vorlagenzusammenfassung aufgeführt ist. Weitere Informationen finden Sie unter Preparing an Application for Future Major Upgrades (Vorbereiten einer Anwendung für zukünftige Hauptupgrades).

Sequenzeinschränkungen

FindRelatedProducts sollte in die Tabellen InstallUISequence und InstallExecuteSequence erstellt werden. Das Installationsprogramm verhindert die Ausführung von FindRelated Products in InstallExecuteSequence, wenn die Aktion bereits in InstallUISequence ausgeführt wurde. Die Aktion FindRelatedProducts muss vor der MigrateFeatureStates-Aktion und der RemoveExistingProducts-Aktion kommen.

ActionData-Meldungen

FindRelatedProducts sendet eine Aktionsdatenmeldung für jedes zugehörige Produkt, das im System erkannt wird.