Função MsiReinstallProductA (msi.h)

Artigo
11/20/2024

A função MsiReinstallProduct reinstala 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 ser um ou mais 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 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 só repara arquivos que têm msidbFileAttributesChecksum na coluna Atributos da tabela arquivo .
REINSTALLMODE_FILEREPLACE	Force todos os arquivos a serem reinstalados, independentemente da soma de verificação ou da versão.
REINSTALLMODE_USERDATA	Reescreva todas as entradas necessárias do Registro do da Tabela do Registro que vão para o HKEY_CURRENT_USER ou HKEY_USERS hive do registro.
REINSTALLMODE_MACHINEDATA	Reescreva todas as entradas necessárias do Registro do da Tabela do Registro que vão para o HKEY_LOCAL_MACHINE ou HKEY_CLASSES_ROOT hive do registro. Reescreva todas as informações dode tabela de classe , de tabela de verbos, de tabela PublishComponent, de tabela progID, de tabela MIMET, de tabela de ícones, de tabela de extensão e da tabela AppID, independentemente da atribuição do computador ou do 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 de retorno

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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

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

várias instalações de pacote

propriedade REINSTALLMODE

Compartilhar via