Tabela MsiEmbeddedUI

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.

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.