Analyse des messages Windows Installer

Un gestionnaire d’interface utilisateur externe peut traiter la liste des messages du programme d’installation spécifiés par le paramètre dwMessagedFilter de la fonction MsiSetExternalUI. Certains de ces messages contiennent des chaînes qui peuvent être utilisées directement, et d’autres messages peuvent avoir besoin d’être analysés et traités par le gestionnaire d’interface utilisateur externe pour être utiles. Votre gestionnaire d’interface utilisateur externe n’a peut-être besoin que de surveiller les messages Windows Installer sans effectuer d’opération qui affecte l’installation.

Les messages Windows Installer suivants contiennent des chaînes qui peuvent être affichées par une boîte de dialogue et ne nécessitent aucun traitement supplémentaire. Ces messages contiennent une liste de boutons et d’icônes qui doivent être affichés par une boîte de dialogue. Vous pouvez utiliser les valeurs MB_ICONMASK, MB_DEFMASK et MB_TYPEMASK pour spécifier des icônes et des boutons.

INSTALLMESSAGE_FATALEXIT

Un arrêt prématuré de l’installation s’est produit.

INSTALLMESSAGE_ERROR

Message d’erreur mis en forme.

INSTALLMESSAGE_WARNING

Message d’avertissement mis en forme.

INSTALLMESSAGE_INFO

Message de journal mis en forme.

INSTALLMESSAGE_USER

Message utilisateur mis en forme.

INSTALLMESSAGE_OUTOFDISKSPACE

Message mis en forme indiquant une condition d’espace disque insuffisant

Le gestionnaire d’utilisateurs externes peut utiliser les messages Windows Installer suivants pour surveiller une séquence de l’interface utilisateur de Windows Installer. Le programme d’installation envoie ces messages au début d’une séquence d’interface utilisateur Windows Installer, à mesure que chaque boîte de dialogue s’affiche et à la fin de la séquence d’interface utilisateur. Aucun traitement n’est nécessaire pour utiliser ces messages.

INSTALLMESSAGE_TERMINATE

Ce message indique la fin de la séquence d’interface utilisateur. La chaîne est une chaîne null.

INSTALLMESSAGE_INITIALIZE

Ce message indique que la séquence d’interface utilisateur a démarré. La chaîne est une chaîne null.

INSTALLMESSAGE_SHOWDIALOG

La chaîne contient le nom de la boîte de dialogue active.

Les messages Windows Installer suivants nécessitent un traitement supplémentaire par le gestionnaire d’interface utilisateur externe.

INSTALLMESSAGE_RESOLVESOURCE

Le gestionnaire d’interface utilisateur externe doit retourner 0 et autoriser Windows Installer à gérer le message. Le gestionnaire d’interface utilisateur externe peut surveiller ce message, mais il ne doit effectuer aucune action affectant l’installation .

INSTALLMESSAGE_FILESINUSE

L’interface utilisateur externe doit afficher une boîte de dialogue FilesInUse en réponse à ce message.

INSTALLMESSAGE_RMFILESINUSE

L’interface utilisateur externe doit afficher une boîte de dialogue FilesInUse en réponse à ce message. Disponible à partir de Windows Installer version 4.0. Pour plus d’informations, consultez Utilisation du Gestionnaire de redémarrage avec une interface utilisateur externe.

INSTALLMESSAGE_ACTIONSTART

Ce message fournit des informations sur l’action en cours. Le format est Action [1] : [2]. [3], où un signe deux-points est utilisé pour séparer le champ 1 et le champ 2 et où un point est utilisé pour séparer les champs 2 et 3. Le champ [1] contient l’heure à laquelle l’action a démarré à l’aide du format de propriété Time . Le champ [2] contient le nom de l’action de la table de séquence. Le champ [3] indique la description de l’action à partir de la table ActionText ou de la fonction MsiProcessMessage .

INSTALLMESSAGE_ACTIONDATA

Le format de cette chaîne est spécifié par la valeur Template fournie dans la table ActionText ou par la fonction MsiProcessMessage . Il peut y avoir un nombre illimité de messages INSTALLMESSAGE_ACTIONDATA après le message INSTALLMESSAGE_ACTIONSTART .

INSTALLMESSAGE_COMMONDATA

Ce message comporte trois sous-types : Langue, Légende et CancelShow. La chaîne peut avoir trois champs délimités par un nombre suivi d’un signe deux-points. Les champs ne sont pas tous obligatoires. Le message peut être une chaîne NULL ou vide («  »).

Langue

Le champ 1 contient la valeur 0 pour indiquer que cette chaîne contient des informations sur la langue. Le champ 2 contient une valeur Langue qui constitue un identificateur de langue numérique (LANGID). Le champ 3 est une valeur représentant une page de codes ANSI.

Légende

Le champ 1 contient la valeur 1 pour indiquer que cette chaîne contient le texte d’une légende ou d’un titre. Le champ 2 contient du texte qu’un gestionnaire d’interface utilisateur externe peut utiliser comme légende de titre pour une boîte de dialogue. Le champ 3 a la valeur NULL ou une chaîne («  ») vide. Le champ 3 peut être absent d’un message de légende.

CancelShow

Le champ 1 contient la valeur 2 pour indiquer que cette chaîne contient des informations sur l’affichage ou non du bouton Annuler. Si le bouton Annuler doit être masqué, le champ 2 contient la valeur 0. Si le bouton Annuler doit être visible, le champ 2 contient la valeur 1.

INSTALLMESSAGE_PROGRESS

Ce message comporte quatre sous-types : Réinitialiser, ActionInfo, ProgressReport et ProgressAddition. Le gestionnaire externe ne doit pas agir sur l’un de ces messages tant que le premier message de progression de la réinitialisation n’a pas été reçu. Cela fournit une estimation du nombre total de graduations pour la barre de progression.

R

Le champ 1 contient la valeur 0 pour indiquer une réinitialisation de la barre de progression. Le champ 2 contient le nombre total de graduations dans la barre de progression. Le champ 3 contient la valeur 0 pour le mouvement de barre de progression. Le champ 3 contient la valeur 1 pour le mouvement de barre de progression vers l’arrière. La valeur 0 dans le champ 4 signifie que l’installation est en cours et que le temps restant peut être calculé. La valeur 1 dans le champ 4 signifie que le script est en cours d’exécution et qu’un « Veuillez patienter... » message peut être affiché. L’estimation du nombre total de graduations est une approximation et peut être inexacte.

ActionInfo

Le champ 1 contient la valeur 1 pour indiquer que cette chaîne contient des informations d’action. Le champ 2 contient le nombre de cases que la barre de progression déplace pour chaque message ActionData envoyé par l’action actuelle. Si le champ 3 contient la valeur 0, ignorez le champ 2. Si le champ 3 contient la valeur 1, incrémentez la barre de progression par le nombre de cases dans le champ 2 pour chaque message ActionData envoyé par l’action en cours. Le champ 4 n’est pas utilisé.

ProgressReport

Le champ 1 contient la valeur 2 pour indiquer que cette chaîne contient des informations sur la progression. Le champ 2 contient le nombre de cases que la barre de progression a déplacées. Le champ 3 n’est pas utilisé. Le champ 4 n’est pas utilisé.

ProgressAddition

Le champ 1 contient la valeur 3 pour indiquer qu’une action peut ajouter des cases à la barre de progression. Le champ 2 contient le nombre de graduations à ajouter au nombre total attendu de graduations de progression. Le champ 3 n’est pas utilisé. Le champ 4 n’est pas utilisé.