Envoi de messages à Windows Installer à l’aide de MsiProcessMessage

Les messages envoyés à l’aide de MsiProcessMessage sont les mêmes que ceux reçus par la fonction de rappel INSTALLUI_HANDLER si MsiSetExternalUI a été appelé. Sinon, Windows Installer gère les messages. Pour plus d’informations, consultez Analyse des messages Windows Installer.

Par exemple, pour envoyer un message INSTALLMESSAGE_ERROR avec l’icône MB_ICONWARNING et les boutons MB_ABORTRETRYCANCEL :

PMSIHANDLE hInstall;
PMSIHANDLE hRec;
MsiProcessMessage(hInstall, INSTALLMESSAGE(INSTALLMESSAGE_ERROR|MB_ABORTRETRYIGNORE|MB_ICONWARNING), hRec);

Où hInstall est le descripteur de l’installation, fourni à une action personnalisée ou le descripteur hProduct à partir de MsiOpenProduct ou MsiOpenPackage, et hRec est l’enregistrement contenant les informations d’erreur à mettre en forme. Pour plus d’informations sur la façon dont la mise en forme est effectuée, consultez MsiFormatRecord.

Par défaut, si un message INSTALLMESSAGE_ERROR ou INSTALLMESSAGE_FATALEXIT est envoyé sans spécifier le type de bouton ou les types d’icônes, MB_OK, aucune icône et MB_DEFBUTTON1 sont utilisés.

Windows Installer n’étiquette pas le bouton ABORT avec la chaîne « Abort » lors de l’affichage d’une MessageBox avec la spécification du bouton MB_ABORTRETRYIGNORE, mais l’étiquette le bouton avec la chaîne « Cancel ». Tous les messages d’erreur s’abstiennent d’utiliser le mot « Abort » et utilisent à la place le mot « Cancel ».

Le paramètre hRecord de la fonction MsiProcessMessage dépend du type de message envoyé au MsiProcessMessage. La liste suivante détaille les exigences de l’enregistrement par rapport au type de message :

INSTALLMESSAGE_FATALEXIT

 

INSTALLMESSAGE_INFO

 

INSTALLMESSAGE_OUTOFDISKSPACE

Champ	Description
0	Modèle pour la mise en forme de la chaîne résultante. Pour plus d’informations, consultez MsiFormatRecord. Les champs de l’enregistrement sont référencés à l’aide de [1] pour le champ 1, [2] pour le champ 2, etc.
1 à n	Tous les champs suivants sont directement liés aux champs référencés par le modèle dans le champ 0.

 

Si le champ 0 a la valeur null, la chaîne reçue par le gestionnaire d’interface utilisateur est mise en forme comme suit : 1 : [données du champ 1] 2 : [données du champ 2], ce qui signifie que pour chaque champ de l’enregistrement, la chaîne contient le numéro de champ suivi des données stockées dans le champ.

Les messages d’informations de MsiProcessMessage sont enregistrés lorsque MsiEnableLog, l’option de ligne de commande « /l » ou la stratégie de journalisation spécifient « I » ou INSTALLLOGMODE_INFO.

INSTALLMESSAGE_ERROR

 

INSTALLMESSAGE_WARNING

 

INSTALLMESSAGE_USER

Pour utiliser un message de la table Error.

Champ	Description
0	Doit être NULL.
1	Numéro de message dans la table Error.
2 à n	Lié au message spécifié dans la table Error.

 

Par exemple,

Champ	Type	Données
0	string	null
1	int	1304
2	string	Myfile.txt

 

Le message obtenu à partir du gestionnaire d’interface utilisateur est le suivant :

Erreur 1304. Erreur d’écriture dans le fichier : Myfile.txt. Vérifiez que vous êtes autorisé à accéder à ce répertoire.

Si le champ 0 n’est pas null, le message de la table d’erreurs est remplacé. Au lieu de cela, le modèle de champ 0 détermine le format du message.

Le message peut également spécifier les boutons, y compris le bouton par défaut, et l’icône à utiliser avec le message, comme mentionné ci-dessus. Les types de boutons et d’icônes sont répertoriés dans INSTALLUI_HANDLER.

INSTALLMESSAGE_COMMONDATA

Ce message est envoyé pour activer ou désactiver le bouton Annuler dans une boîte de dialogue de progression.

Champ	Description
0	Inutilisé.
1	2 fait référence au bouton Annuler.
2	La valeur 1 indique que le bouton Annuler doit être visible. La valeur 0 indique que le bouton Annuler doit être invisible.

 

Par exemple, pour désactiver ou masquer le bouton Annuler, l’enregistrement apparaît comme suit.

Champ	Type	Données
0	string	null
1	int	2
2	int	0

 

INSTALLMESSAGE_ACTIONSTART

 

INSTALLMESSAGE_ACTIONDATA

L’enregistrement INSTALLMESSAGE_ACTIONSTART détermine le format de l’enregistrement ActionData.

Champ	Description
0	null
1	Nom de l’action. Le nom dans ce champ doit être non null.
2	Description de l’action.
3	Modèle d’action. Il est utilisé pour les ActionData dont le message est mis en forme selon ce modèle.

 

Ne référencez pas le champ 0 dans le message du modèle d’action.

L’enregistrement INSTALLMESSAGE_ACTIONDATA est mis en forme comme suit.

Champ	Description
0	null
1 à n	Dépend du champ 3 du message ou modèle INSTALLMESSAGE_ACTIONSTART correspondant spécifié dans la table ActionText.

 

Par exemple, l’enregistrement INSTALLMESSAGE_ACTIONSTART.

Champ	Type	Données
0	string	null
1	string	MyAction
2	string	Il s’agit de la description de « MyAction »
3	string	Modèle MyAction : les données du champ 1 sont [1]. Les données du champ 2 sont [2].

 

Le modèle pour INSTALLMESSAGE_ACTIONSTART (champ 3) fait référence aux champs 1 et 2, l’enregistrement INSTALLMESSAGE_ACTIONDATA doit avoir 2 champs contenant les données justifiées. Les champs peuvent être des champs de chaîne ou d’entier.

Enregistrement INSTALLMESSAGE_ACTIONDATA.

Champ	Type	Données
0	string	null
1	int	2
2	string	ActionData pour MyAction

 

INSTALLMESSAGE_FILESINUSE

L’enregistrement FILESINUSE est un enregistrement de longueur variable.

Champ	Description
0	Ce champ peut contenir la valeur null. Pour une installation utilisant une interface utilisateur de base, ce champ peut spécifier du texte statique à afficher dans le contrôle ListBox de la boîte de dialogue FilesInUse. Pour une installation utilisant une interface utilisateur complète, ce champ n’a aucun effet, car le texte est spécifié par la création de la boîte de dialogue FilesInUse personnalisée.
1	Nom du fichier utilisé.
2	Ce champ identifie le processus contenant le fichier en cours d’utilisation. Windows Installer version 4.0 : L’ID de processus (PID) du processus, ou le titre de la fenêtre du processus. Windows Installer 3.1 et versions antérieures : Ce champ doit être l’ID de processus (PID) du processus.

 

Par exemple, pour envoyer un message FilesInUse affichant deux fichiers en cours d’utilisation, red.exe et blue.exe, l’enregistrement comporte quatre champs plus le champ 0. Le format de l’enregistrement est celui indiqué dans le tableau suivant. Cet exemple nécessite Windows Installer version 4.0.

Windows Installer 3.1 et versions antérieures : Les champs 2 et 4 de l’exemple suivant doivent contenir les PID des processus contenant red.exe et blue.exe en cours d’utilisation.

Champ	Description
0	null
1	Red.exe
2	Titre de la fenêtre rouge
3	Blue.exe
4	Titre de la fenêtre bleue

 

Notes

Sur Windows Installer version 4.0, si le PID transmis à partir du service n’a pas de titre de fenêtre, comme une application de barre d’état système, le fichier n’est pas affiché et le journal détaillé contient les messages suivants.

 

File In Use: -<FileName>- Window could not be found. Process ID: <PID>
No window with title could be found for FilesInUse

INSTALLMESSAGE_RESOLVESOURCE

L’enregistrement INSTALLMESSAGE_RESOLVESOURCE comporte sept champs. Pour qu’INSTALLMESSAGE_RESOLVESOURCE fonctionne correctement, un gestionnaire d’interface utilisateur externe peut ne pas gérer le message INSTALLMESSAGE_RESOLVESOURCE. Windows Installer doit gérer le message INSTALLMESSAGE_RESOLVESOURCE. Autrement dit, le gestionnaire d’interface utilisateur externe retourne 0 pour indiquer « aucune action effectuée » lors du filtrage du message INSTALLMESSAGE_RESOLVESOURCE. La meilleure pratique consiste à éviter d’envoyer un message RESOLVESOURCE.

Champ	Description
0	null
1	null
2	Nom du package.
3	Code du produit.
4	Le chemin d’accès relatif, s’il est connu, peut être null.
5	0
6	Indique s’il faut valider le code du package. La valeur « 1 » indique que le code du package doit être validé. La valeur « 0 » indique que le package ne doit pas être validé.
7	Disque requis à partir de la table multimédia. La valeur « 0 » indique que tout disque est acceptable.