Ação FindRelatedProducts

A ação FindRelatedProducts é executada em cada registro da tabela Upgrade em sequência e compara o código de atualização, a versão do produto e o idioma em cada linha com os produtos instalados no sistema. Quando FindRelatedProducts detecta uma correspondência entre as informações de atualização e um produto instalado, ele acrescenta o código do produto à propriedade especificada na coluna ActionProperty da UpgradeTable.

A ação FindRelatedProducts só é executada na primeira vez que o produto é instalado. A ação FindRelatedProducts não é executada durante o modo de manutenção ou de desinstalação.

Tabelas de banco de dados consultadas

Essa ação consulta a seguinte tabela:

Tabela Upgrade

Propriedades usadas

A ação FindRelatedProducts usa a propriedade UpgradeCode e as informações de versão e idioma criadas na tabela Upgrade para detectar os produtos instalados afetados pela atualização pendente. Ela acrescenta o código dos produtos detectados à propriedade na coluna ActionProperty da UpgradeTable.

FindRelatedProducts só reconhece os produtos existentes que foram instalados por meio do Windows Installer com um .msi que define uma propriedade UpgradeCode, uma propriedade ProductVersion e um valor para a propriedade ProductLanguage que é um dos idiomas listados na propriedade Template Summary.

Observe que FindRelatedProducts usa a linguagem retornada por MsiGetProductInfo. Para que FindRelatedProducts funcione corretamente, o autor do pacote precisa ter certeza de que a propriedade ProductLanguage na tabela Property está definida como um idioma que também está listado na propriedade Template Summary. Confira Como preparar um aplicativo para futuras atualizações principais.

Restrições de sequência

FindRelatedProducts deve ser criado nas tabelas InstallUISequence e InstallExecuteSequence. O instalador impedirá a execução de FindRelated Products em InstallExecuteSequence se a ação já tiver sido executada em InstallUISequence. A ação FindRelatedProducts precisa vir antes da ação MigrateFeatureStates e da ação RemoveExistingProducts.

Mensagens de ActionData

FindRelatedProducts envia uma mensagem de dados de ação para cada produto relacionado detectado no sistema.