Recommandations relatives aux messages ICE
Les actions personnalisées ICE communiquent en appelant MsiProcessMessage et en publiant un message de type INSTALLMESSAGE_USER.
Lors de la création d’une chaîne de message pour une action personnalisée ICE, mettez la chaîne en forme comme suit.
Nom de l’ICE<tabulation>Type de message<tabulation>Description<tabulation>URL d’aide ou emplacement<tabulation>Nom de table<tabulation>Nom de colonne<tabulation>Clé primaire<tabulation>Clé primaire<tabulation>Clé primaire. . . (répéter pour autant de clés primaires que nécessaire)
Les trois premiers champs de la chaîne sont requis dans chaque message.
Le champ Type de message spécifie si l’ICE signale un message d’échec, d’erreur, d’avertissement ou d’information.
| Valeur | type de message |
|---|---|
| 0 | Message d’échec signalant l’échec de l’action personnalisée ICE. |
| 1 | Message d’erreur rapportant la création d’une base de données qui provoque un comportement incorrect. |
| 2 | Message d’avertissement signalant la création d’une base de données qui provoque un comportement incorrect dans certains cas. Les avertissements peuvent également signaler des effets secondaires inattendus de la création de bases de données. |
| 3 | Message d’information. |
Si l’aide n’est pas disponible, le champ URL d’aide peut être la chaîne vide.
Les messages d’erreur et d’avertissement doivent fournir les champs Nom de la table, Nom de la colonne et Clé primaire. Si l’un de ces champs est omis, tous les champs qui suivent le premier champ vide doivent être laissés hors du message. Par exemple, un nom de table est fourni sans nom de colonne ni clés primaires, ou un nom de table et un nom de colonne sont fournis sans clés primaires. Toutefois, un nom de colonne et des clés primaires ne peuvent pas être utilisés sans nom de table. Plusieurs clés primaires peuvent être répertoriées jusqu’à ce que toutes les clés primaires de cette table aient reçu des valeurs.
Exemples
Premier message illustré par l’Exemple d’ICE en C++ :
« ICE01\t3\tCreated le 29/04/1998 en <insérant le nom de l’auteur ici>. »
Deuxième message publié par l’exemple d’ICE :
« ICE01\t3\tLast modifié le 06/05/1999 en <insérant le nom de l’auteur ici>. »
Troisième message publié par l’exemple d’ICE :
« ICE01\t3\tSimple ICE pour illustrer le concept d’ICE ».