Função MsiConfigureProductA (msi.h)

Artigo
11/20/2024

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 estiver definido como qualquer outro valor que não 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.

Valor de retorno

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

Observações

A função MsiConfigureProduct exibe a interface do usuário (interface do usuário) usando as configurações atuais. As configurações de interface do usuário podem ser alteradas usando msiSetInternalUI, msiSetExternalUI ou msiSetExternalUIRecord.

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.

Nota

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

instalações Multiple-Package

Compartilhar via