FindRelatedProducts アクション

FindRelatedProducts アクションは、Upgrade テーブルの各レコードに対して順番に実行され、各行のアップグレード コード、製品バージョン、言語をシステムにインストールされている製品と比較します。 FindRelatedProducts は、アップグレード情報とインストールされている製品の間の対応関係を検出すると、UpgradeTable の ActionProperty 列で指定されているプロパティに製品コードを追加します。

FindRelatedProducts アクションは、製品が初めてインストールされたときにのみ実行されます。 FindRelatedProducts アクションは、メンテナンス モードまたはアンインストール中には実行されません。

クエリが実行されるデータベース テーブル

このアクションは、次のテーブルに対してクエリを実行します。

Upgrade テーブル

使用されるプロパティ

FindRelatedProducts アクションは、Upgrade テーブルに作成された UpgradeCode プロパティとバージョンおよび言語情報を使用して、保留中のアップグレードによって影響を受けるインストールされている製品を検出します。 検出された製品の製品コードを UpgradeTable の ActionProperty 列内のプロパティに追加します。

FindRelatedProducts は、UpgradeCode プロパティ、ProductVersion プロパティのほか、Template Summary プロパティにリストされている言語の 1 つである ProductLanguage プロパティの値を定義する .msi で Windows インストーラーを使用してインストールされている既存の製品のみを認識します。

FindRelatedProducts では、MsiGetProductInfo によって返された言語が使用されることに注意してください。 FindRelatedProducts を正しく機能させるには、パッケージ作成者は、Property テーブル内の ProductLanguage プロパティが、Template Summary プロパティにもリストされている言語に設定されていることを確認する必要があります。 「将来のメジャー アップグレード用のアプリケーションの準備」を参照してください。

シーケンスの制限

FindRelatedProducts は、InstallUISequence テーブルと InstallExecuteSequence テーブルに作成する必要があります。 アクションが既に InstallUISequence で実行されている場合、インストーラーは FindRelated Products が InstallExecuteSequence で実行されないようにします。 FindRelatedProducts アクションは、MigrateFeatureStates アクションと RemoveExistingProducts アクションの前に指定する必要があります。

ActionData メッセージ

FindRelatedProducts は、システム上で検出した関連する製品ごとにアクション データ メッセージを送信します。