Ação FindRelatedProducts

A ação FindRelatedProducts é executada por cada registro da tabela de atualização 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 desinstalação.

Tabelas de banco de dados consultadas

Esta ação consulta a tabela a seguir:

da Tabela de Atualização

Propriedades usadas

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

FindRelatedProducts reconhece apenas os produtos existentes que foram instalados usando o Windows Installer com um .msi que define uma propriedade UpgradeCode, uma propriedade ProductVersion e um valor para a propriedadeProductLanguage que é uma das linguagens listadas na propriedaderesumo do modelo de.

Observe que FindRelatedProducts usa o idioma retornado por msiGetProductInfo. Para que FindRelatedProducts funcione corretamente, o autor do pacote deve ter certeza de que a propriedade ProductLanguage na tabela Property está definida como um idioma que também está listado na propriedaderesumo do modelo de. Consulte Preparando um aplicativo para futuras atualizações principais.

Restrições de sequência

FindRelatedProducts deve ser criado nas tabelas InstallUISequence e InstallExecuteSequence. O instalador impede que os Produtos FindRelated sejam executados em InstallExecuteSequence se a ação já tiver sido executada em InstallUISequence. A ação FindRelatedProducts deve vir antes da ação MigrateFeatureStates e da ação RemoveExistingProducts.

Mensagens ActionData

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