Renvoi de messages d’erreur à partir d’actions personnalisées

  • Article

Cette section explique comment envoyer des messages à partir d’actions personnalisées qui effectuent une partie de l’installation en appelant une bibliothèque de liens dynamiques ou un script. Notez que ce type d’action personnalisée 19 n’envoie qu’un message d’erreur spécifié, retourne un échec, puis met fin à l’installation. Le type d’action personnalisé 19 n’effectue aucune partie de l’installation.

Pour envoyer un message d’erreur à partir d’une action personnalisée qui utilise une bibliothèque de liens dynamiques (DLL), faites appel à l’action personnalisée msiProcessMessage. Notez que les actions personnalisées lancées par un DoAction ControlEvent peuvent envoyer des messages avec la méthode Message, mais ne peuvent pas envoyer de message avec MsiProcessMessage. Sur les systèmes antérieurs à Windows Server 2003, les actions personnalisées lancées par DoAction ControlEvent ne peuvent pas envoyer de messages avec MsiProcessMessage ni la méthode Message. Pour obtenir plus d’informations, consultez Envoi de messages au programme d’installation Windows à l’aide de MsiProcessMessage.

Pour afficher un message d’erreur à partir d’une action personnalisée à l’aide d’une DLL

  1. L’action personnalisée doit appeler MsiProcessMessage et passer les paramètres hInstall, eMessageType et hRecord. Le descripteur de l’installation, Type d’action personnalisée 19, peut être fourni à l’action personnalisée, comme décrit dans Accès à la session d’installation actuelle à partir d’une action personnalisée ou à partir de MsiOpenProduct ou MsiOpenPackage.
  2. Le paramètre eMessageType doit spécifier l’un des types de messages répertoriés dans MsiProcessMessage.
  3. Le paramètre hRecord de la fonction MsiProcessMessage dépend du type de message. Consultez Envoi de messages a programme d’installation Windows à l’aide de MsiProcessMessage. Si le message contient des données mises en forme, entrez le message dans la table Erreur à l’aide de la mise en forme décrite dans Mise en forme.

Pour envoyer un message d’erreur à partir d’une action personnalisée qui utilise Scripts, l’action personnalisée peut appeler la méthode Message de l’objet Session.

Pour afficher un message d’erreur à partir d’une action personnalisée à l’aide d’un script

  1. L’action personnalisée doit appeler la méthode Message de l’objet Session et transmettre le type et l’enregistrement des paramètres.
  2. Le type de paramètre doit spécifier l’un des types de messages répertoriés dans la méthode Message.
  3. Le paramètre d’enregistrement de la méthode Message dépend du type de message. Si le message contient des données mises en forme, entrez le message dans la table Erreur à l’aide de la mise en forme décrite dans Mise en forme.

Les actions personnalisées utilisant des fichiers exécutables ne peuvent pas envoyer de message en appelant MsiProcessMessage ni la méthode Message, car elles ne peuvent pas obtenir de descripteur pour l’installation.

Valeurs de retour des actions personnalisées