Reinstalar um recurso ou um aplicativo

O Windows Installer pode reparar, substituir e verificar os arquivos contidos em um aplicativo. Uma reinstalação parcial ou completa do aplicativo poderá ser necessária se os arquivos ou entradas de registro associados a qualquer recurso estiverem ausentes ou corrompidos.

Quando um recurso ou um aplicativo é reinstalado, todos os serviços, variáveis de ambiente e ações personalizadas pertencentes ao recurso ou ao aplicativo também serão reinstalados. Isso significa que todas as alterações feitas nas variáveis de ambiente entre a instalação original e a reinstalação serão perdidas.

A lista a seguir contém métodos de reinstalação de um recurso ou um produto. Os dois primeiros métodos foram automatizados pelo instalador:

• Reparar, substituir ou verificar os arquivos chamando a função MsiReinstallFeature.
• Reinstale todo o produto chamando a função MsiReinstallProduct.
• Reinstale, substitua ou verifique os arquivos com um botão de controle de interface do usuário do instalador por meio do ControlEvent de reinstalação.
• Reinstale, substitua ou verifique os arquivos de uma linha de comando definindo a propriedade REINSTALL e a propriedade REINSTALLMODE.

Para obter mais informações sobre como reinstalar um recurso ou um aplicativo, consulte Resiliência.

Para reinstalar um produto usando o instalador

• Chame MsiReinstallProduct.

Para reinstalar um recurso usando o instalador

• Chame MsiReinstallFeature.

Para reinstalar um produto ou um recurso com uma interface do usuário do instalador

1. Inclua um botão à caixa de diálogo especificada adicionando uma entrada à tabela de Controle.

2. Adicione um ReinstallMode ControlEvent à tabela ControlEvent, com os campos Dialog_ e Control_ referenciando o controle de botão criado na etapa 1. No campo de Argumento, insira uma cadeia de caracteres contendo as letras correspondentes aos modos de reinstalação desejados (os valores aceitáveis para esse campo são idênticos aos aceitos para a propriedade REINSTALLMODE). O valor na coluna de Ordenação para esse evento deve ser 1.

3. Adicione um evento Reinstalar ControlEvent à tabela ControlEvent, referenciando novamente o mesmo controle de botão. O campo de Argumento para esse evento normalmente será ALL, para forçar a reinstalação de todos os recursos, mas você pode colocar o nome de um recurso específico aqui. O valor na coluna de Ordenação para esse evento deve ser 2.

4. Adicione mais um evento vinculado ao mesmo controle de botão para realmente iniciar a reinstalação. Isso pode ser um evento EndDialog (com um argumento de retorno). Com mais frequência, no entanto, aqui seria utilizado um evento NewDialog para ir a uma caixa de diálogo Tem certeza de que deseja reinstalar?. O valor na coluna de Ordenação para esse evento deve ser 3.

   Se desejar, vários botões de REINSTALAR poderão ser criados para uma única caixa de diálogo, permitindo ao usuário selecionar o tipo de reinstalação realizada. Nesse caso, cada botão será criado conforme descrito no procedimento anterior com um parâmetro ControlEvent ReinstallMode diferente para cada botão.

Após a instalação de um determinado produto (com alguns ou todos os recursos do produto), a reinstalação poderá ser realizada na linha de comando:

Para reinstalar um produto ou um recurso de uma linha de comando

1. No prompt de comando, especifique a propriedade REINSTALL .

2. No prompt de comando, especifique a propriedade REINSTALLMODE.

   A especificação dessas propriedades permite que o usuário reinstale alguns ou todos os recursos do produto. Também será possível especificar o tipo de reinstalação. Por exemplo, você pode especificar que apenas os arquivos que estão completamente ausentes deverão ser reinstalados ou que apenas os arquivos corrompidos (por exemplo, qualquer arquivo executável cuja soma de verificação não corresponda ao conteúdo real do arquivo) sejam substituídos.