Função MsiGetMode (msiquery.h)
A função MsiGetMode é usada para determinar se o instalador está em execução no momento em um modo especificado, conforme listado na tabela. A função retorna um valor booliano de TRUE ou FALSE, indicando se a propriedade específica passada para a função está atualmente definida (TRUE) ou não definida (FALSE).
Sintaxe
BOOL MsiGetMode(
[in] MSIHANDLE hInstall,
[in] MSIRUNMODE eRunMode
);
Parâmetros
[in] hInstall
Manipule para a instalação fornecida a uma ação personalizada de DLL ou obtida por meio de MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.
[in] eRunMode
Especifica o modo de execução. Esse parâmetro deve ter um dos valores a seguir.
| Valor | Significado |
|---|---|
|
O modo administrativo está sendo instalado ou o produto está sendo instalado. |
|
Os anúncios estão sendo instalados ou o produto está instalando ou atualizando. |
|
Uma instalação existente está sendo modificada ou há uma nova instalação. |
|
A reversão está habilitada. |
|
O arquivo de log está ativo. Ele foi habilitado antes da sessão de instalação. |
|
As operações de execução estão na fase de determinação. |
|
Uma reinicialização é necessária após uma instalação bem-sucedida (configurável). |
|
Uma reinicialização é necessária para continuar a instalação (configurável). |
|
Arquivos de gabinetes e arquivos de tabela de mídia estão sendo instalados. |
|
O LongFileNames de origem é suprimido por meio da propriedade de resumo PID_MSISOURCE. |
|
O LongFileNames de destino é suprimido por meio da propriedade SHORTFILENAMES . |
|
Reservado para uso futuro. |
|
O sistema operacional é uma versão 9x. |
|
O sistema operacional dá suporte à instalação de demanda. |
|
Reservado para uso futuro. |
|
Reservado para uso futuro. |
|
Uma ação personalizada chamada da execução do script de instalação. |
|
Uma ação personalizada chamada do script de execução de reversão. |
|
Uma ação personalizada chamada do script de execução de confirmação. |
Valor retornado
TRUE indica que a propriedade específica passada para a função está definida no momento.
FALSE indica que a propriedade específica passada para a função não está definida no momento.
Comentários
Observe que nem todos os valores de modo de execução de iRunMode estão disponíveis ao chamar MsiGetMode de uma ação personalizada adiada. Para obter detalhes, consulte Obtendo informações de contexto para ações personalizadas de execução adiada.
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. Windows Installer no Windows Server 2003 ou no Windows XP |
| Plataforma de Destino | Windows |
| Cabeçalho | msiquery.h |
| Biblioteca | Msi.lib |
| DLL | Msi.dll |