Partilhar via


Ação RemoveExistingProducts

A ação RemoveExistingProducts percorre os códigos de produto listados na coluna ActionProperty da tabela Upgrade e remove os produtos em sequência invocando instalações simultâneas. Para cada instalação simultânea, o instalador define a propriedade ProductCode para o código do produto e define a propriedade REMOVE para o valor no campo Remove da tabela Upgrade. Se o campo Remover estiver em branco, seu valor padrão será ALL e o instalador removerá todo o produto.

O instalador só executa a ação RemoveExistingProducts na primeira vez que instala um produto. Ele não executa a ação durante uma instalação de manutenção ou desinstalação.

Restrições de sequência

A ação RemoveExistingProducts deve ser agendada na sequência de ações em um dos seguintes locais.

  • Entre a ação InstallValidate e a ação InstallInitialize. Neste caso, o instalador remove os aplicativos antigos inteiramente antes de instalar os novos aplicativos. Este é um posicionamento ineficiente para a ação porque todos os arquivos reutilizados têm que ser recopiados.
  • Após o ação InstallInitialize e antes de quaisquer ações que gerem script de execução.
  • Entre a ação InstallExecuteou a ação InstallExecuteAgaine a ação InstallFinalize. Geralmente, as três últimas ações são agendadas logo após a outra: InstallExecute, RemoveExistingProducts e InstallFinalize. Neste caso, os arquivos atualizados são instalados primeiro e, em seguida, os arquivos antigos são removidos. No entanto, se a remoção do aplicativo antigo falhar, o instalador reverterá a remoção do aplicativo antigo e a instalação do novo aplicativo.
  • Após o ação InstallFinalize. Este é o posicionamento mais eficiente para a ação. Nesse caso, o instalador atualiza os arquivos antes de remover os aplicativos antigos. Somente os arquivos que estão sendo atualizados são instalados durante a instalação. Se a remoção do aplicativo antigo falhar, o instalador apenas reverterá a desinstalação do aplicativo antigo.

Mensagens ActionData

Domínio Descrição dos dados da ação
[1] Produto removido.

 

Comentários

O Windows Installer define a UPGRADINGPRODUCTCODE Property quando executa esta ação.