Acción FindRelatedProducts

La acción FindRelatedProducts se ejecuta a través de cada registro de la tabla Upgrade en secuencia y compara el código de actualización, la versión del producto y el idioma de cada fila con los productos instalados en el sistema. Cuando FindRelatedProducts detecta una correspondencia entre la información de actualización y un producto instalado, anexa el código del producto a la propiedad especificada en la columna ActionProperty de UpgradeTable.

La acción FindRelatedProducts solo se ejecuta la primera vez que se instala el producto. La acción FindRelatedProducts no se ejecuta durante el modo de mantenimiento ni durante la desinstalación.

Tablas de bases de datos consultadas

Esta acción consulta la tabla siguiente:

Tabla Upgrade

Propiedades usadas

La acción FindRelatedProducts usa la propiedad UpgradeCode y la información de versión e idioma creadas en la tabla Upgrade para detectar los productos instalados afectados por la actualización pendiente. Anexa el código de producto de los productos detectados a la propiedad en la columna ActionProperty de UpgradeTable.

FindRelatedProducts solo reconoce los productos existentes que se han instalado mediante Windows Installer con un .msi que define una propiedad UpgradeCode, una propiedad ProductVersion y un valor de la propiedad ProductLanguage que es uno de los idiomas enumerados en la propiedad Template Summary.

Tenga en cuenta que la acción FindRelatedProducts usa el idioma devuelto por MsiGetProductInfo. Para que FindRelatedProducts funcione correctamente, el creador del paquete debe asegurarse de que la propiedad ProductLanguage de la tabla Property esté establecida en un idioma que también aparezca en la propiedad Template Summary. Consulte Preparar una aplicación para futuras actualizaciones principales.

Restricciones de secuencia

FindRelatedProducts debe crearse en la tabla InstallUISequence y en la tabla InstallExecuteSequence. El instalador impide que FindRelatedProducts se ejecute en InstallExecuteSequence si la acción ya se ha ejecutado en InstallUISequence. La acción FindRelatedProducts debe aparecer antes de la acción MigrateFeatureStates y la acción RemoveExistingProducts.

Mensajes ActionData

FindRelatedProducts envía un mensaje de datos de acción para cada producto relacionado que detecta en el sistema.