Função MsiConfigureProductExA (msi.h)
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.
[in] eInstallState
Especifica o estado de instalação do produto. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
O produto deve ser instalado com todos os recursos instalados localmente. |
|
O produto está desinstalado. |
|
O produto deve ser instalado com todos os recursos instalados para execução da origem. |
|
O produto deve ser instalado com todos os recursos instalados nos estados padrão especificados na Tabela de Recursos. |
|
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 |
|---|---|
|
Um parâmetro inválido é passado para a função . |
|
A função foi bem-sucedida. |
|
Para obter mais informações, veja os Códigos de Erro. |
| 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 |