Compartilhar via


Ação RemoveExistingProducts

A ação RemoveExistingProducts passa pelos códigos do 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 REMOVEcomo o valor no campo Remover da tabela De atualização. Se o campo Remover estiver em branco, seu valor será padrão para ALL e o instalador removerá todo o produto.

O instalador só executa a ação RemoveExistingProducts na primeira vez em 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 locais a seguir.

  • Entre a ação InstallValidate e a ação InstallInitialize. Nesse caso, o instalador remove totalmente os aplicativos antigos antes de instalar os novos aplicativos. Esse é um posicionamento ineficiente para a ação porque todos os arquivos reutilizados precisam ser copiados novamente.
  • Após o a ação InstallInitialize e antes de qualquer ação que gere 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 umas após as outras: InstallExecute, RemoveExistingProducts e InstallFinalize. Nesse 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.
  • Depois que a ação InstallFinalize. Esse é 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 só reverterá a desinstalação do aplicativo antigo.

Mensagens ActionData

Campo Descrição dos dados de ação
[1] Produto removido.

 

Observações

O Windows Installer define o UPGRADINGPRODUCTCODE Property ao executar essa ação.