Função MsiConfigureProductExA (msi.h)

Artigo
08/24/2023

A função MsiConfigureProductEx instala ou desinstala um produto. Uma linha de comando do produto também pode ser especificada.

Sintaxe

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

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. Os parâmetros iInstallLevel são ignorados e todos os recursos são instalados, se o parâmetro eInstallState for definido como qualquer valor diferente de 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.

[in] szCommandLine

Especifica as configurações da propriedade de linha de comando. Essa deve ser uma lista do formato Property=Setting Property=Setting. Para obter mais informações, confira Sobre propriedades.

Valor retornado

Valor	Significado
ERROR_INVALID_PARAMETER	Um parâmetro inválido é passado para a função .
ERROR_SUCCESS	A função foi 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

A linha de comando passada como szCommandLine pode conter qualquer uma das Propriedades de Opções de Instalação de Recurso. Nesse caso, o eInstallState passado deve ser INSTALLSTATE_DEFAULT.

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.

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

Observação

O cabeçalho msi.h define MsiConfigureProductEx 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. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o Windows service pack mínimo exigido por uma versão do Windows Installer.
Plataforma de Destino	Windows
Cabeçalho	msi.h
Biblioteca	Msi.lib
DLL	Msi.dll