MsiEmbeddedUI (tabla)

La tabla MsiEmbeddedUI define una interfaz de usuario incrustada en el paquete de Windows Installer.

Windows Installer 4.0 o versiones anteriores: no compatible. Esta tabla está disponible a partir de Windows Installer 4.5.

La tabla MsiEmbeddedChainer tiene las siguientes columnas.

Columna Tipo Clave Nullable
MsiEmbeddedUI Identificador Y No
FileName Texto No No
Atributos Entero No No
MessageFilter DoubleInteger No Y
data Binario No No

 

Columnas

MsiEmbeddedUI

Clave principal de la tabla.

FileName

Nombre del archivo que recibe la información binaria en la columna Data. El nombre del archivo es necesario para incluir una extensión. Por ejemplo, el nombre embeddedui.dll es aceptable, pero embeddedui no es aceptable. El nombre puede estar localizado. Este campo puede contener un nombre de archivo corto o un nombre de archivo largo, pero no puede contener ambos. El formato de este campo es como el tipo de datos de la columna Filename, salvo que el separador de barra vertical (|) para la sintaxis de nombre de archivo corto/nombre de archivo largo no está disponible. Dado que algunos servidores web pueden distinguir mayúsculas de minúsculas, FileName debe coincidir exactamente con las mayúsculas/minúsculas de los archivos de origen para, así, garantizar una correcta compatibilidad con las descargas de Internet.

Attributes

Información sobre los datos de la columna Data. El valor de este campo puede contener una o varias de las constantes siguientes.

Constante Hexadecimal Decimal Significado
Ninguno 0x00 0 El archivo no es el archivo DLL de la interfaz de usuario. Puede ser un archivo de recursos que usa la interfaz de usuario.
msidbEmbeddedUI 0x01 1 El archivo DLL principal de la interfaz de usuario. No se puede marcar con este atributo más de una fila de la tabla. Si hay varias filas marcadas con este atributo, se trata de un error y no se puede garantizar qué DLL se usa.
msidbEmbeddedHandlesBasic 0x02 2 Permite al instalador invocar la interfaz de usuario insertada durante una instalación básica de nivel de interfaz de usuario. El instalador omite este atributo si no se combina con el atributo msidbEmbeddedUI.

 

MessageFilter

Especifica los tipos de mensajes que se envían al archivo DLL de la interfaz de usuario. Esta columna solo es relevante para las filas con el atributo msidbEmbeddedUI. Este campo debe ser nulo si una fila hace referencia a un archivo de recursos y el valor de Attributes es nulo. Si una fila hace referencia a un archivo DLL de interfaz de usuario, el valor de esta columna no debe ser NULL.

El valor de esta columna puede ser una combinación de los valores siguientes. El instalador omite cualquier otro valor.

Constante Hexadecimal Decimal Descripción
INSTALLLOGMODE_FATALEXIT 0x00001 1 Terminación prematura.
INSTALLLOGMODE_ERROR 0x00002 2 Mensajes de error.
INSTALLLOGMODE_WARNING 0x00004 4 Mensajes de advertencia
INSTALLLOGMODE_USER 0x00008 8 Mensajes de usuario.
INSTALLLOGMODE_INFO 0x00010 16 Mensajes de estado no registrados.
INSTALLLOGMODE_FILESINUSE 0x00020 32 Archivos que se encuentran actualmente en uso.
INSTALLLOGMODE_RESOLVESOURCE 0x00040 64 Solicitudes de resolución de origen.
INSTALLLOGMODE_OUTOFDISKSPACE 0x00080 128 Mensajes de espacio en disco.
INSTALLLOGMODE_ACTIONSTART 0x00100 256 Acción de inicio de mensajes.
INSTALLLOGMODE_ACTIONDATA 0x00200 512 Mensajes de datos de acción.
INSTALLLOGMODE_PROGRESS 0x00400 1024 Mensajes de progreso.
INSTALLLOGMODE_COMMONDATA 0x00800 2048 Mensajes de inicialización de la interfaz de usuario.
INSTALLLOGMODE_INITIALIZE 0x01000 4096 Mensajes de inicio de la interfaz de usuario enviados cuando se inicia una instalación del producto.
INSTALLLOGMODE_TERMINATE 0x02000 8192 Mensajes de apagado de la interfaz de usuario enviados una vez finalizada la instalación de un producto.
INSTALLLOGMODE_SHOWDIALOG 0x04000 16384 Mensajes enviados antes de la presentación del cuadro de diálogo de interfaz de usuario.
INSTALLLOGMODE_RMFILESINUSE 0x02000000 33554432 Archivos que se encuentran actualmente en uso.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 Comienzo de la instalación del producto. El mensaje contiene el ProductName y ProductCode del producto.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 Finalización de la instalación del producto. El mensaje contiene el valor ProductName, ProductCode y el valor devuelto del producto.

 

Data

Esta columna contiene información binaria. Si el campo Attribute está marcado con el atributo msidbEmbeddedUI, la información de este campo debe ser un archivo DLL. Si el campo Attribute no es el atributo msidbEmbeddedUI, la información de este campo puede ser un archivo de recursos en cualquier formato.

Comentarios

Para usar una interfaz de usuario insertada, el desarrollador de instalación debe crear esta funcionalidad en el paquete de Windows Installer. La tabla MsiEmbeddedUI define la interfaz de usuario insertada. El archivo DLL de la interfaz de usuario insertada debe exportar las funciones InitializeEmbeddedUI, EmbeddedUIHandler y ShutdownEmbeddedUI. Los paquetes que no admiten una interfaz de usuario insertada pueden usar la interfaz de usuario interna de Windows Installer.

Para ejecutar herramientas de depuración para Windows en una interfaz de usuario insertada, use las técnicas descritas en Depuración de acciones personalizadas. Establezca el valor de MsiBreak en MsiEmbeddedUI.

Para obtener un ejemplo de una interfaz de usuario personalizada insertada, consulte Uso de una interfaz de usuario insertada.