Compartilhar via


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
REINSTALLMODE_FILEMISSING
Reinstale somente se o arquivo estiver ausente.
REINSTALLMODE_FILEOLDERVERSION
Reinstale se o arquivo estiver ausente ou se for uma versão mais antiga.
REINSTALLMODE_FILEEQUALVERSION
Reinstale se o arquivo estiver ausente ou se for uma versão igual ou mais antiga.
REINSTALLMODE_FILEEXACT
Reinstale se o arquivo estiver ausente ou se for uma versão diferente.
REINSTALLMODE_FILEVERIFY
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.
REINSTALLMODE_FILEREPLACE
Forçar a reinstalação de todos os arquivos, independentemente da soma de verificação ou da versão.
REINSTALLMODE_USERDATA
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.
REINSTALLMODE_MACHINEDATA
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 .

REINSTALLMODE_SHORTCUT
Reinstale todos os atalhos e armazene em cache novamente todos os ícones substituindo quaisquer atalhos e ícones existentes.
REINSTALLMODE_PACKAGE
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
ERROR_INSTALL_FAILURE
Falha na instalação.
ERROR_INVALID_PARAMETER
Um parâmetro inválido foi passado para a função.
ERROR_INSTALL_SERVICE_FAILURE
Não foi possível acessar o serviço de instalação.
ERROR_INSTALL_SUSPEND
A instalação foi suspensa e está incompleta.
ERROR_INSTALL_USEREXIT
O usuário cancelou a instalação.
ERROR_SUCCESS
A função foi concluída com êxito.
ERROR_UNKNOWN_PRODUCT
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

Confira também

Funções de instalação e configuração

Várias instalações de pacote

Propriedade REINSTALLMODE