Tabela MsiEmbeddedUI

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

Windows Installer 4.0 ou 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 de	Y	N
Filename	de Texto	N	N
Atributos	inteiro	N	N
MessageFilter	DoubleInteger	N	Y
Dados	Binário	N	N

 

Colunas

MsiEmbeddedUI

A chave primária da tabela.

FileName

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 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 é como o tipo de dados filename coluna, 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, o FileName deve corresponder ao caso dos arquivos de origem exatamente para garantir o suporte aos downloads da Internet.

Atributos de

Informações sobre os dados na coluna Dados. 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 é 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 que são enviadas para a DLL da interface do usuário. Esta coluna é relevante apenas para linhas com o atributo msidbEmbeddedUI. Esse campo deverá 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 de interface do usuário, o valor nesta coluna não deverá ser nulo.

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

Constante	Hexadecimal	Decimal	Descrição
INSTALLLOGMODE_FATALEXIT	0x00001	1	Término 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 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 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 atualmente mantidos em uso.
INSTALLLOGMODE_INSTALLSTART	0x04000000	67108864	A instalação do produto começa. A mensagem contém o ProductName e o ProductCode do produto.
INSTALLLOGMODE_INSTALLEND	0x08000000	134217728	Instalação de extremidades do produto. A mensagem contém o ProductName, o ProductCode e o valor retornado do produto.

 

Dados do

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

Observações

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, EmbeddedUIHandlere shutdownEmbeddedUI. Pacotes que não dão suporte a uma interface do usuário inserida podem usar a interface do usuário interna do Windows Installer.

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

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