Table MsiEmbeddedUI

La table MsiEmbeddedUI définit une interface utilisateur incorporée dans le package Windows Installer.

Windows Installer 4.0 ou versions antérieures : non prises en charge. Cette table est disponible à partir de Windows Installer 4.5.

La table MsiEmbeddedUI contient les colonnes suivantes.

Colonne	Type	Clé	Nullable
MsiEmbeddedUI	Identificateur	O	N
FileName	Texte	N	N
Attributs	Integer	N	N
MessageFilter	DoubleInteger	N	O
Données	Binaire	N	N

 

Colonnes

MsiEmbeddedUI

Clé primaire de la table.

FileName

Nom du fichier qui reçoit les informations binaires dans la colonne Data. Le nom du fichier est requis pour inclure une extension. Par exemple, le nom embeddedui.dll est acceptable, mais embeddedui est inacceptable. Le nom peut être localisé. Ce champ peut contenir un nom de fichier court ou un nom de fichier long, mais il ne peut pas contenir les deux. Le format de ce champ est similaire au type de données de colonne Filename, sauf que le séparateur de barre verticale (|) pour la syntaxe nom de fichier court/nom de fichier long n’est pas disponible. Étant donné que certains serveurs web peuvent respecter la casse, FileName doit correspondre exactement à la casse des fichiers sources pour garantir la prise en charge des téléchargements Internet.

Attributs

Informations sur les données dans la colonne Data. La valeur de ce champ peut contenir une ou plusieurs des constantes suivantes.

Constante	Valeur hexadécimale	Decimal	Signification
Aucun	0x00	0	Le fichier n’est pas le fichier DLL de l’interface utilisateur. Il peut s’agir d’un fichier de ressources utilisé par l’interface utilisateur.
msidbEmbeddedUI	0x01	1	Fichier DLL principal pour l’interface utilisateur. Il n’est pas possible de marquer plus d’une ligne de la table avec cet attribut. Si plusieurs lignes sont marquées avec cet attribut, il s’agit d’une erreur et il n’est pas possible de garantir quelle DLL est utilisée.
msidbEmbeddedHandlesBasic	0x02	2	Permet au programme d’installation d’appeler l’interface utilisateur incorporée lors d’une installation au niveau de l’interface utilisateur de base. Le programme d’installation ignore cet attribut s’il n’est pas combiné avec l’attribut msidbEmbeddedUI.

 

MessageFilter

Spécifie les types de messages qui sont envoyés à la DLL d’interface utilisateur. Cette colonne s’applique uniquement aux lignes avec l’attribut msidbEmbeddedUI. Ce champ doit avoir la valeur Null si une ligne fait référence à un fichier de ressources et que la valeur Attributes est Null. Si une ligne fait référence à une DLL d’interface utilisateur, la valeur de cette colonne ne doit pas être Null.

La valeur de cette colonne peut être une combinaison des valeurs suivantes. Le programme d’installation ignore toutes les autres valeurs.

Constante	Valeur hexadécimale	Decimal	Description
INSTALLLOGMODE_FATALEXIT	0x00001	1	Arrêt prématuré.
INSTALLLOGMODE_ERROR	0x00002	2	Messages d’erreur.
INSTALLLOGMODE_WARNING	0x00004	4	Messages d’avertissement.
INSTALLLOGMODE_USER	0x00008	8	Messages utilisateur.
INSTALLLOGMODE_INFO	0x00010	16	Messages d’état non journalisés.
INSTALLLOGMODE_FILESINUSE	0x00020	32	Fichiers actuellement en cours d’utilisation.
INSTALLLOGMODE_RESOLVESOURCE	0x00040	64	Demandes de résolution de la source.
INSTALLLOGMODE_OUTOFDISKSPACE	0x00080	128	Messages d’espace disque.
INSTALLLOGMODE_ACTIONSTART	0x00100	256	Messages de démarrage d’action.
INSTALLLOGMODE_ACTIONDATA	0x00200	512	Messages de données d’action.
INSTALLLOGMODE_PROGRESS	0x00400	1 024	Messages de progression.
INSTALLLOGMODE_COMMONDATA	0x00800	2 048	Messages d’initialisation de l’interface utilisateur.
INSTALLLOGMODE_INITIALIZE	0x01000	4096	Messages de démarrage de l’interface utilisateur envoyés au démarrage d’un produit.
INSTALLLOGMODE_TERMINATE	0x02000	8 192	Messages d’arrêt de l’interface utilisateur envoyés une fois l’installation d’un produit terminée.
INSTALLLOGMODE_SHOWDIALOG	0x04000	16384	Messages envoyés avant l’affichage de la boîte de dialogue d’interface utilisateur.
INSTALLLOGMODE_RMFILESINUSE	0x02000000	33554432	Fichiers actuellement en cours d’utilisation.
INSTALLLOGMODE_INSTALLSTART	0x04000000	67108864	L’installation du produit commence. Le message contient les ProductName et ProductCode du produit.
INSTALLLOGMODE_INSTALLEND	0x08000000	134217728	Installation des extrémités du produit. Le message contient les valeurs ProductName, ProductCode et return du produit.

 

Données

Cette colonne contient des informations binaires. Si le champ Attribut est marqué avec l’attribut msidbEmbeddedUI, les informations contenues dans ce champ doivent être une DLL. Si le champ Attribut n’est pas l’attribut msidbEmbeddedUI, les informations contenues dans ce champ peuvent être un fichier de ressources dans n’importe quel format.

Notes

Pour utiliser une interface utilisateur incorporée, le développeur de l’installation doit créer cette fonctionnalité dans le package Windows Installer. La table MsiEmbeddedUI définit l’interface utilisateur incorporée. La DLL de l’interface utilisateur incorporée doit exporter les fonctions InitializeEmbeddedUI, EmbeddedUIHandler et ShutdownEmbeddedUI. Les packages qui ne prennent pas en charge une interface utilisateur incorporée peuvent utiliser l’interface utilisateur interne de Windows Installer.

Pour exécuter les Outils de débogage pour Windows sur une interface utilisateur incorporée, utilisez les techniques décrites dans Débogage d’actions personnalisées. Définissez la valeur de MsiBreak sur MsiEmbeddedUI.

Pour obtenir un exemple d’interface utilisateur personnalisée incorporée, consultez Utilisation d’une interface utilisateur incorporée.