Função MsiReinstallFeatureA (msi.h)

  • Artigo

A função MsiReinstallFeature reinstala os recursos.

Sintaxe

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

Parâmetros

[in] szProduct

Especifica o código do produto para o produto que contém o recurso a ser reinstalado.

[in] szFeature

Especifica o recurso a ser reinstalado. O recurso pai ou filho do recurso especificado não é reinstalado. Para reinstalar o recurso pai ou filho, você deve chamar a função MsiReinstallFeature para cada um separadamente ou usar a função MsiReinstallProduct .

[in] dwReinstallMode

Especifica o que instalar. 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 Verbos, Tabela PublishComponent, Tabela ProgID, Tabela MIME, Tabela de ícones, Tabela de extensões e 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 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_FEATURE
 A ID do recurso não identifica um recurso conhecido.
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 MsiReinstallFeature 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

Instalações de vários pacotes

Propriedade REINSTALLMODE