Função MsiReinstallProductA (msi.h)
A função MsiReinstallProduct reinstala os produtos.
Sintaxe
UINT MsiReinstallProductA(
[in] LPCSTR szProduct,
[in] DWORD szReinstallMode
);
Parâmetros
[in] szProduct
Especifica o código do produto para o produto a ser reinstalado.
[in] szReinstallMode
Especifica o modo de reinstalação. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Reinstale somente se o arquivo estiver ausente. |
|
Reinstale se o arquivo estiver ausente ou se for uma versão mais antiga. |
|
Reinstale se o arquivo estiver ausente ou se for uma versão igual ou mais antiga. |
|
Reinstale se o arquivo estiver ausente ou se for uma versão diferente. |
|
Verifique os valores de soma de verificação e reinstale o arquivo se eles estiverem ausentes ou corrompidos. Esse sinalizador apenas repara arquivos que têm msidbFileAttributesChecksum na coluna Atributos da tabela File. |
|
Forçar a reinstalação de todos os arquivos, independentemente da soma de verificação ou da versão. |
|
Reescreva todas as entradas do Registro necessárias da Tabela do Registro que vão para o HKEY_CURRENT_USER ou HKEY_USERS hive do registro. |
|
Reescreva todas as entradas do Registro necessárias da Tabela do Registro que vão para HKEY_LOCAL_MACHINE ou HKEY_CLASSES_ROOT hive do registro. Reescreva todas as informações da Tabela de Classes, Tabela de Verbo, Tabela PublishComponent, Tabela ProgID, Tabela MIMET, Tabela de Ícones, Tabela de Extensões e Tabela AppID , independentemente da atribuição de computador ou usuário. Reinstale todos os componentes qualificados.
Ao reinstalar um aplicativo, essa opção executa as ações RegisterTypeLibraries e InstallODBC . |
|
Reinstale todos os atalhos e armazene em cache novamente todos os ícones substituindo quaisquer atalhos e ícones existentes. |
|
Use para executar no pacote de origem e armazenar novamente em cache o pacote local. Não use para a primeira instalação de um aplicativo ou recurso. |
Valor retornado
| Código de retorno | Descrição |
|---|---|
|
Falha na instalação. |
|
Um parâmetro inválido foi passado para a função. |
|
Não foi possível acessar o serviço de instalação. |
|
A instalação foi suspensa e está incompleta. |
|
O usuário cancelou a instalação. |
|
A função foi concluída com êxito. |
|
O código do produto não identifica um produto conhecido. |
Para obter mais informações, consulte Mensagens de erro exibidas.
Comentários
Observação
O cabeçalho msi.h define MsiReinstallProduct como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer. |
| Plataforma de Destino | Windows |
| Cabeçalho | msi.h |
| Biblioteca | Msi.lib |
| DLL | Msi.dll |