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 動作之前。
FindRelatedProducts 會針對在系統上偵測到的每個相關產品傳送動作資料訊息。