Função MsiReinstallFeatureA (msi.h)

Artigo
11/20/2024

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 o recurso 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 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 do class Table, Verb Table, PublishComponent Table, ProgID Table, MIME Table, Icon Table, Extension Tablee AppID Table 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_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.

Observações

Nota

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 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

instalações Multiple-Package

propriedade REINSTALLMODE

Compartilhar via