Função MsiGetMode (msiquery.h)

  • Artigo

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
MSIRUNMODE_ADMIN
 O modo administrativo está sendo instalado ou o produto está sendo instalado.
MSIRUNMODE_ADVERTISE
 Os anúncios estão sendo instalados ou o produto está instalando ou atualizando.
MSIRUNMODE_MAINTENANCE
 Uma instalação existente está sendo modificada ou há uma nova instalação.
MSIRUNMODE_ROLLBACKENABLED
 A reversão está habilitada.
MSIRUNMODE_LOGENABLED
 O arquivo de log está ativo. Ele foi habilitado antes da sessão de instalação.
MSIRUNMODE_OPERATIONS
 As operações de execução estão na fase de determinação.
MSIRUNMODE_REBOOTATEND
 Uma reinicialização é necessária após uma instalação bem-sucedida (configurável).
MSIRUNMODE_REBOOTNOW
 Uma reinicialização é necessária para continuar a instalação (configurável).
MSIRUNMODE_CABINET
 Arquivos de gabinetes e arquivos de tabela de mídia estão sendo instalados.
MSIRUNMODE_SOURCESHORTNAMES
 O LongFileNames de origem é suprimido por meio da propriedade de resumo PID_MSISOURCE.
MSIRUNMODE_TARGETSHORTNAMES
 O LongFileNames de destino é suprimido por meio da propriedade SHORTFILENAMES .
MSIRUNMODE_RESERVED11
 Reservado para uso futuro.
MSIRUNMODE_WINDOWS9X
 O sistema operacional é uma versão 9x.
MSIRUNMODE_ZAWENABLED
 O sistema operacional dá suporte à instalação de demanda.
MSIRUNMODE_RESERVED14
 Reservado para uso futuro.
MSIRUNMODE_RESERVED15
 Reservado para uso futuro.
MSIRUNMODE_SCHEDULED
 Uma ação personalizada chamada da execução do script de instalação.
MSIRUNMODE_ROLLBACK
 Uma ação personalizada chamada do script de execução de reversão.
MSIRUNMODE_COMMIT
 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

Confira também

Funções de acesso ao estado do instalador