Função MsiConfigureProductExA (msi.h)

Artigo
11/20/2024

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 estiver definido como qualquer valor diferente de INSTALLSTATE_DEFAULT.

Esse parâmetro pode ser 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 sã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 ser 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 ser executado na origem.
INSTALLSTATE_DEFAULT	O produto deve ser instalado com todos os recursos instalados nos estados padrão especificados noda 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, consulte Sobre propriedades.

Valor de retorno

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, consulte códigos de erro.
de erro de inicialização	Ocorreu um erro relacionado à inicialização.

Observações

A linha de comando passada como szCommandLine pode conter qualquer uma das propriedades de opções de instalação de recursos . Nesse caso, o eInstallState passado deve ser INSTALLSTATE_DEFAULT.

O parâmetro iInstallLevel é ignorado e todos os recursos do produto serão instalados se o parâmetro eInstallState estiver 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 de interface do usuário podem ser alteradas com msiSetInternalUI, msiSetExternalUIou MsiSetExternalUIRecord.

Nota

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

mensagens de erro exibidas

códigos de erro

de erro de inicialização

Funções de instalação e configuração

instalações Multiple-Package

Compartilhar via