Função MsiConfigureFeatureA (msi.h)

Artigo
08/24/2023

A função MsiConfigureFeature configura o estado instalado para um recurso de produto.

Sintaxe

UINT MsiConfigureFeatureA(
  [in] LPCSTR       szProduct,
  [in] LPCSTR       szFeature,
  [in] INSTALLSTATE eInstallState
);

Parâmetros

[in] szProduct

Especifica o código do produto para o produto a ser configurado.

[in] szFeature

Especifica a ID do recurso a ser configurado.

[in] eInstallState

Especifica o estado de instalação do recurso. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
INSTALLSTATE_ADVERTISED	O recurso é anunciado
INSTALLSTATE_LOCAL	O recurso é instalado localmente.
INSTALLSTATE_ABSENT	O recurso é desinstalado.
INSTALLSTATE_SOURCE	O recurso é instalado para ser executado a partir da origem.
INSTALLSTATE_DEFAULT	O recurso é instalado em seu local padrão.

Valor retornado

Valor	Significado
ERROR_INVALID_PARAMETER	Um parâmetro inválido é passado para a função .
ERROR_SUCCESS	A função é bem-sucedida.
Um erro relacionado a uma ação	Para obter mais informações, veja os Códigos de Erro.
Erro de inicialização	Ocorreu um erro relacionado à inicialização.

Comentários

Observação

O cabeçalho msi.h define MsiConfigureFeature 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