Partager via

Table MsiEmbeddedUI

  • Article

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.