Partilhar via


Ação FindRelatedProducts

A ação LocalizarProdutos Relacionados é executada em cada registro do da tabela Atualização do 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 deteta 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 seguinte tabela:

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 Upgrade para detetar produtos instalados afetados pela atualização pendente. Ele acrescenta o código do produto dos produtos detetados à propriedade na coluna ActionProperty da UpgradeTable.

FindRelatedProducts só reconhece 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 propriedade ProductLanguage que é um dos idiomas listados no Template Summary Property.

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 no Template Summary Property. Consulte Preparando um aplicativo para futuras atualizações importantes.

Restrições de sequência

FindRelatedProducts deve ser criado no da tabela InstallUISequence e tabelas InstallExecuteSequence. O instalador impede que FindRelated Products seja executado 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 que deteta no sistema.