Partilhar via

Tabela MsiEmbeddedUI

  • Artigo

A tabela MsiEmbeddedUI define uma interface de usuário incorporada no pacote do Windows Installer.

Windows Installer 4.0 ou anterior: Não suportado. Esta tabela está disponível a partir do Windows Installer 4.5.

A tabela MsiEmbeddedUI tem as seguintes colunas.

Coluna Tipo Chave Nulo
MsiEmbeddedUI Identificador Y N
Nome do arquivo de texto N N
Atributos inteiro N N
MessageFilter DoubleInteger N Y
Dados binário N N

 

Colunas

MsiEmbeddedUI

A chave primária para a tabela.

Nome do arquivo

O nome do arquivo que recebe as informações binárias na coluna Dados. O nome do arquivo é necessário para incluir uma extensão. Por exemplo, o nome embeddedui.dll é aceitável, mas embeddedui é inaceitável. O nome pode estar localizado. Este campo pode conter um nome de ficheiro curto ou um nome de ficheiro longo, mas não pode conter ambos. O formato deste campo é como o tipo de dados Nome do arquivo coluna, exceto que o separador de barra vertical (|) para a sintaxe nome de arquivo curto/nome de arquivo longo não está disponível. Como alguns servidores Web podem diferenciar maiúsculas de minúsculas, FileName deve corresponder exatamente ao caso dos arquivos de origem para garantir o suporte a downloads da Internet.

Atributos

Informações sobre os dados na coluna Dados. O valor neste campo pode conter uma ou mais das seguintes constantes.

Constante Hexadecimal Decimal Significado
Nenhum 0x00 0 O arquivo não é o arquivo DLL para a interface do usuário. Pode ser um arquivo de recurso usado pela interface do usuário.
msidbEmbeddedUI 0x01 1 O arquivo DLL primário para a interface do usuário. Não mais do que uma linha na tabela pode ser marcada com este atributo. Se várias linhas são marcadas com esse atributo, é um erro e não pode ser garantido qual DLL é usado.
msidbEmbeddedHandlesBasic 0x02 2 Permite que o instalador invoque a interface do usuário incorporada durante uma instalação básica no nível da interface do usuário. O instalador ignora esse atributo se ele não for combinado com o atributo msidbEmbeddedUI.

 

MessageFilter

Especifica os tipos de mensagens que são enviadas para a DLL da interface do usuário. Esta coluna só é relevante para linhas com o atributo msidbEmbeddedUI. Este campo deve ser nulo se uma linha fizer referência a um arquivo de recurso e o valor de Atributos for nulo. Se uma linha fizer referência a uma DLL da interface do usuário, o valor nesta coluna não deverá ser nulo.

O valor nesta coluna pode ser uma combinação dos seguintes valores. O instalador ignora quaisquer outros valores.

Constante Hexadecimal Decimal Descrição
INSTALLLOGMODE_FATALEXIT 0x00001 1 Rescisão prematura.
INSTALLLOGMODE_ERROR 0x00002 2 Mensagens de erro.
INSTALLLOGMODE_WARNING 0x00004 4 Mensagens de aviso.
INSTALLLOGMODE_USER 0x00008 8 Mensagens de utilizador.
INSTALLLOGMODE_INFO 0x00010 16 Mensagens de status não registradas.
INSTALLLOGMODE_FILESINUSE 0x00020 32 Arquivos atualmente mantidos em uso.
INSTALLLOGMODE_RESOLVESOURCE 0x00040 64 Solicitações de resolução de origem.
INSTALLLOGMODE_OUTOFDISKSPACE 0x00080 128 Mensagens de espaço em disco.
INSTALLLOGMODE_ACTIONSTART 0x00100 256 Mensagens de início de ação.
INSTALLLOGMODE_ACTIONDATA 0x00200 512 Mensagens de dados de ação.
INSTALLLOGMODE_PROGRESS 0x00400 1024 Mensagens de progresso.
INSTALLLOGMODE_COMMONDATA 0x00800 2048 Mensagens de inicialização da interface do usuário.
INSTALLLOGMODE_INITIALIZE 0x01000 4096 Mensagens de inicialização da interface do usuário enviadas quando a instalação de um produto está sendo iniciada.
INSTALLLOGMODE_TERMINATE 0x02000 8192 Mensagens de desligamento da interface do usuário enviadas após a conclusão da instalação do produto.
INSTALLLOGMODE_SHOWDIALOG 0x04000 16384 Mensagens enviadas antes da exibição da caixa de diálogo da interface do usuário.
INSTALLLOGMODE_RMFILESINUSE 0x02000000 33554432 Arquivos atualmente mantidos em uso.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 Inicia-se a instalação do produto. A mensagem contém o ProductName e o ProductCode do produto.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 Instalação dos fins do produto. A mensagem contém o ProductName, o ProductCode e o valor de retorno do produto.

 

Dados

Esta coluna contém informações binárias. Se o campo Atributo estiver marcado com o atributo msidbEmbeddedUI, as informações nesse campo deverão ser uma DLL. Se o campo Atributo não for o atributo msidbEmbeddedUI, as informações nesse campo podem ser um arquivo de recurso em qualquer formato.

Comentários

Para usar uma interface de usuário incorporada, o desenvolvedor de instalação deve criar essa funcionalidade no pacote do Windows Installer. A tabela MsiEmbeddedUI define a interface do usuário incorporada. A DLL para a interface do usuário incorporada deve exportar o InitializeEmbeddedUI, EmbeddedUIHandlere funções de ShutdownEmbeddedUI. Os pacotes que não suportam uma interface de utilizador incorporada podem utilizar a interface de utilizador interna do Windows Installer.

Para executar Ferramentas de Depuração para Windows em uma interface de usuário incorporada, use as técnicas descritas em Debugging Custom Actions. Defina o valor de MsiBreak como MsiEmbeddedUI.

Para obter um exemplo de uma interface do usuário personalizada incorporada, consulte Usando uma interface do usuário incorporada.