FindRelatedProducts 動作

FindRelatedProducts 巨集指令會依序執行 Upgrade 資料表 的每個記錄，並將每個資料列中的升級程式碼、產品版本和語言與安裝在系統上的產品進行比較。 當 FindRelatedProducts 偵測到升級資訊與已安裝產品之間的對應時，它會將產品名稱附加至 UpgradeTable 之 ActionProperty 資料行中指定的屬性。

FindRelatedProducts 巨集指令只會在第一次安裝產品時執行。 FindRelatedProducts 巨集指令不會在維護模式或卸載期間執行。

查詢的資料庫資料表

此動作會查詢下表：

升級資料表

使用的屬性

FindRelatedProducts 巨集指令會使用 UpgradeCode 屬性，以及撰寫至 Upgrade 資料表的版本和語言資訊，來偵測受擱置升級影響的已安裝產品。 它會將偵測到產品的產品名稱附加至 UpgradeTable 之 ActionProperty 資料行中的 屬性。

FindRelatedProducts 只會辨識使用 Windows Installer 安裝的現有產品 .msi，其中包含定義 UpgradeCode 屬性、 ProductVersion 屬性，以及 ProductLanguage 屬性的值，這是 範本摘要 屬性中列出的其中一種語言。

請注意，FindRelatedProducts 使用 MsiGetProductInfo所傳回的語言。 若要讓 FindRelatedProducts 正常運作，套件作者必須確定Property 資料表中的ProductLanguage屬性已設定為範本摘要屬性中也會列出的語言。 請參閱 準備應用程式以進行未來的主要升級。

序列限制

FindRelatedProducts 應該撰寫到 InstallUISequence 資料表 和 InstallExecuteSequence 資料表中。 如果動作已在 InstallUISequence 中執行，安裝程式會防止 FindRelated Products 在 InstallExecuteSequence 中執行。 FindRelatedProducts 巨集指令必須位於 MigrateFeatureStates 巨集指令 和 RemoveExistingProducts 動作之前。

ActionData 訊息

FindRelatedProducts 會針對在系統上偵測到的每個相關產品傳送動作資料訊息。