Função MsiSetInternalUI (msi.h)

  • Artigo

A função MsiSetInternalUI habilita a interface interna do usuário do instalador. Em seguida, essa interface do usuário é usada para todas as chamadas subsequentes para funções do instalador gerador de interface do usuário nesse processo. Para obter mais informações, consulte os Níveis da interface do usuário.

Sintaxe

INSTALLUILEVEL MsiSetInternalUI(
  [in]      INSTALLUILEVEL dwUILevel,
  [in, out] HWND           *phWnd
);

Parâmetros

[in] dwUILevel

Especifica o nível de complexidade da interface do usuário. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
INSTALLUILEVEL_FULL
 Interface do usuário criada com assistentes, progresso e erros.
INSTALLUILEVEL_REDUCED
 Interface do usuário criada com caixas de diálogo do assistente suprimidas.
INSTALLUILEVEL_BASIC
 Progresso simples e tratamento de erros.
INSTALLUILEVEL_DEFAULT
 O instalador escolhe um nível de interface do usuário apropriado.
INSTALLUILEVEL_NONE
 Instalação Totalmente Silenciosa. Isso inclui suprimir o prompt de elevação mesmo se necessário. Consulte INSTALLUILEVEL_UACONLY se você quiser que o usuário possa elevar.
INSTALLUILEVEL_ENDDIALOG
 Se combinado com qualquer valor acima, o instalador exibirá uma caixa de diálogo modal no final de uma instalação bem-sucedida ou se houve um erro. Nenhuma caixa de diálogo será exibida se o usuário cancelar.
INSTALLUILEVEL_PROGRESSONLY
 Se combinado com o valor INSTALLUILEVEL_BASIC , o instalador mostrará caixas de diálogo de progresso simples, mas não exibirá caixas de diálogo modais ou caixas de diálogo de erro.
INSTALLUILEVEL_NOCHANGE
 Nenhuma alteração no nível da interface do usuário. No entanto, se phWnd não for Null, a janela pai poderá ser alterada.
INSTALLUILEVEL_HIDECANCEL
 Se combinado com o valor INSTALLUILEVEL_BASIC , o instalador mostrará caixas de diálogo de progresso simples, mas não exibirá um botão Cancelar na caixa de diálogo. Isso impede que os usuários cancelem a instalação.
INSTALLUILEVEL_SOURCERESONLY
 Se esse valor for combinado com o valor INSTALLUILEVEL_NONE , o instalador exibirá apenas as caixas de diálogo usadas para resolução de origem. Nenhuma outra caixa de diálogo é mostrada. Esse valor não terá efeito se o nível da interface do usuário não for INSTALLUILEVEL_NONE. Ele é usado com uma interface do usuário externa projetada para lidar com toda a interface do usuário, exceto a resolução do código-fonte. Nesse caso, o instalador lida com a resolução do código-fonte.
INSTALLUILEVEL_UACONLY
 Se combinado com o valor INSTALLUILEVEL_NONE , a instalação será completamente silenciosa, exceto pelo prompt de elevação, se for necessário.

[in, out] phWnd

Ponteiro para uma janela. Essa janela se torna o proprietário de qualquer interface do usuário criada. Um ponteiro para o proprietário anterior da interface do usuário é retornado. Se esse parâmetro for nulo, o proprietário da interface do usuário não será alterado.

Valor retornado

O nível de interface do usuário anterior é retornado. Se um dwUILevel inválido for passado, INSTALLUILEVEL_NOCHANGE será retornado.

Comentários

A função MsiSetInternalUI é útil quando o instalador deve exibir uma interface do usuário. Por exemplo, se um recurso estiver instalado, mas a origem for um disco compacto que deve ser inserido, o instalador solicitará ao usuário o disco compacto. Dependendo da natureza da instalação, o aplicativo também pode exibir indicadores de progresso ou consultar o usuário para obter informações.

Quando Msi.dll é carregado, o nível de interface do usuário é definido como DEFAULT e o proprietário da interface do usuário é definido como 0 (ou seja, o proprietário inicial da interface do usuário é a área de trabalho).

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

Confira também

Funções de interface e log