Função MsiConfigureProductA (msi.h)

  • Artigo

A função MsiConfigureProduct instala ou desinstala um produto.

Sintaxe

UINT MsiConfigureProductA(
  [in] LPCSTR       szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState
);

Parâmetros

[in] szProduct

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

[in] iInstallLevel

Especifica quanto do produto deve ser instalado ao instalar o produto em seu estado padrão. O parâmetro iInstallLevel é ignorado e todos os recursos são instalados, se o parâmetro eInstallState for definido como qualquer outro valor que não INSTALLSTATE_DEFAULT.

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
INSTALLLEVEL_DEFAULT
 Os recursos padrão criados são instalados.
INSTALLLEVEL_MINIMUM
 Somente os recursos necessários são instalados. Você pode especificar um valor entre INSTALLLEVEL_MINIMUM e INSTALLLEVEL_MAXIMUM para instalar um subconjunto de recursos disponíveis.
INSTALLLEVEL_MAXIMUM
 Todos os recursos estão instalados. Você pode especificar um valor entre INSTALLLEVEL_MINIMUM e INSTALLLEVEL_MAXIMUM para instalar um subconjunto de recursos disponíveis.

[in] eInstallState

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

Valor Significado
INSTALLSTATE_LOCAL
 O produto deve ser instalado com todos os recursos instalados localmente.
INSTALLSTATE_ABSENT
 O produto está desinstalado.
INSTALLSTATE_SOURCE
 O produto deve ser instalado com todos os recursos instalados para execução da origem.
INSTALLSTATE_DEFAULT
 O produto deve ser instalado com todos os recursos instalados nos estados padrão especificados na Tabela de Recursos.
INSTALLSTATE_ADVERTISED
 O produto é anunciado.

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
 Um erro relacionado à inicialização.

Comentários

A função MsiConfigureProduct exibe a interface do usuário (interface do usuário) usando as configurações atuais. As configurações da interface do usuário podem ser alteradas usando MsiSetInternalUI, MsiSetExternalUI ou MsiSetExternalUIRecord.

O parâmetro iInstallLevel é ignorado e todos os recursos do produto são instalados, se o parâmetro eInstallState for definido como qualquer outro valor que não INSTALLSTATE_DEFAULT. Para controlar a instalação de recursos individuais quando o parâmetro eInstallState não estiver definido como INSTALLSTATE_DEFAULT, use MsiConfigureFeature.

Observação

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

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

Instalações de vários pacotes