Partilhar via

Tabela MsiEmbeddedUI

  • Artigo

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

Windows Installer 4.0 ou versões anteriores: sem suporte. Esta tabela está disponível a partir do Windows Installer 4.5.

A tabela MsiEmbeddedUI tem as colunas a seguir.

Coluna Tipo Chave Nullable
MsiEmbeddedUI Identificador S N
FileName Texto N N
Atributos Inteiro N N
MessageFilter DoubleInteger N S
Dados Binary N N

 

Colunas

MsiEmbeddedUI

A chave primária da tabela.

FileName

O nome do arquivo que recebe as informações binárias na coluna Data. O nome do arquivo é necessário para incluir uma extensão. Por exemplo, o nome embeddedui.dll é aceitável, mas embeddedui não é. O nome pode ser localizado. Esse campo pode conter um nome de arquivo curto ou um nome de arquivo longo, mas não pode conter ambos. O formato desse campo é semelhante ao tipo de dados da coluna Filename, exceto que o separador de barra vertical (|) para a sintaxe de 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 ter maiúsculas e minúsculas exatamente correspondentes aos arquivos de origem para garantir o suporte de downloads da Internet.

Attributes

Informações sobre os dados na coluna Data. O valor nesse 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 é possível marcar mais de uma linha na tabela com esse atributo. Se várias linhas forem marcadas com esse atributo, será um erro e não será possível garantir qual DLL será usada.
msidbEmbeddedHandlesBasic 0x02 2 Permite que o instalador invoque a interface do usuário inserida durante uma instalação básica no nível da interface do usuário. O instalador ignorará esse atributo, se ele não for combinado com o atributo msidbEmbeddedUI.

 

MessageFilter

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

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

Constante Hexadecimal Decimal Descrição
INSTALLLOGMODE_FATALEXIT 0x00001 1 Encerramento prematuro.
INSTALLLOGMODE_ERROR 0x00002 2 Mensagens de erro.
INSTALLLOGMODE_WARNING 0x00004 4 Mensagens de aviso.
INSTALLLOGMODE_USER 0x00008 8 Mensagens do usuário.
INSTALLLOGMODE_INFO 0x00010 16 Mensagens de status não registradas.
INSTALLLOGMODE_FILESINUSE 0x00020 32 Arquivos mantidos em uso no momento.
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 2.048 Mensagens de inicialização da interface do usuário.
INSTALLLOGMODE_INITIALIZE 0x01000 4096 Mensagens de inicialização da interface do usuário enviadas quando uma instalação do 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 de um 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 mantidos em uso no momento.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 A instalação do produto começa. A mensagem contém ProductName e ProductCode do produto.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 A instalação do produto termina. A mensagem contém ProductName, ProductCode e valor retornado do produto.

 

Data

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

Comentários

Para usar uma interface do usuário inserida, o desenvolvedor de instalação deve criar essa funcionalidade no pacote do Windows Installer. A tabela MsiEmbeddedUI define a interface do usuário inserida. A DLL para a interface do usuário inserida deve exportar as funções InitializeEmbeddedUI, EmbeddedUIHandler e ShutdownEmbeddedUI. Os pacotes incompatíveis com uma interface do usuário inserida podem usar a interface do usuário interna do Windows Installer.

Para executar as Ferramentas de Depuração para Windows em uma interface do usuário inserida, use as técnicas descritas em Ações Personalizadas de Depuração. Defina o valor de MsiBreak como MsiEmbeddedUI.

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