méthode Session.Message

La méthode Message de l’objet Session effectue toutes les opérations de journalisation activées et reporte l’exécution à l’objet gestionnaire de l’UI associé au moteur. La journalisation peut être activée de manière sélective pour les différents types de messages. Consultez la méthode EnableLog.

Si le champ d’enregistrement 0 contient une chaîne de mise en forme, il est utilisé pour mettre en forme les données des autres champs. Sinon, si le message est une erreur, un avertissement ou un message d'utilisateur, une tentative de recherche d'un modèle de message dans la table Erreurs de la base de données actuelle sera effectuée en utilisant le numéro d'erreur figurant dans la zone 1 de l'enregistrement des types de messages et des valeurs de retour.

Syntaxe

Session.Message(
  kind,
  record
)

Paramètres

kind

Le paramètre type doit être l’une des valeurs suivantes. Pour afficher une boîte de message avec des boutons push et des icônes, calculez la valeur de type en ajoutant les styles de boîte de message standard utilisés par MessageBox et MessageBoxEx à msiMessageTypeError, msiMessageTypeWarning ou msiMessageTypeUser. Pour plus d'informations, voir la section Remarques ci-dessous.

Constant	Signification
msiMessageTypeFatalExit &H00000000	Interruption prématurée, voire fatale, de la mémoire.
msiMessageTypeError &H01000000	Message d'erreur formaté, [1] est le numéro du message dans la table Erreurs.
msiMessageTypeWarning &H02000000	Message d'avertissement formaté, [1] est le numéro du message dans la table Erreurs.
msiMessageTypeUser &H03000000	Message de requête de l'utilisateur, [1] est le numéro du message dans la table Erreurs.
msiMessageTypeInfo &H04000000	Message d’information pour le journal, à ne pas afficher.
msiMessageTypeFilesInUse &H05000000	Liste des fichiers en cours d’utilisation devant être remplacés.
msiMessageTypeResolveSource &H06000000	Demande de déterminer un emplacement source valide.
msiMessageTypeOutOfDiskSpace &H07000000	Message d'espace disque insuffisant.
msiMessageTypeActionStart &H08000000	Début de l’action, [1] nom de l’action, [2] description, [3] modèle pour les messages ACTIONDATA.
msiMessageTypeActionData &H09000000	Données d’action. Les champs d’enregistrement correspondent au modèle de message ACTIONSTART.
msiMessageTypeProgress &H0A000000	Informations sur la barre de progression. Consultez la description des champs d’enregistrement ci-dessous.
msiMessageTypeCommonData &H0B000000	Pour activer le bouton Annuler, définissez [1] sur 2 et [2] sur 1. Pour désactiver le bouton Annuler, définissez [1] sur 2 et [2] sur 0

 

enregistrement

Objet Enregistrement obligatoire contenant un champ spécifique au message.

Valeur retournée

Notes

Champs d’enregistrement de message

L’exemple suivant décrit les définitions de champ d’enregistrement lorsque msiMessageTypeProgress est passé comme type de message.

Le champ 1 spécifie le type du message de progression. La signification des autres champs dépend de la valeur de ce dernier. Les valeurs possibles pouvant être définies dans le champ 1 sont les suivantes.

La signification de la zone 2 dépend de la valeur de la zone 1 comme indiqué ci-après.

La signification du champ 3 dépend de la valeur du champ 1 comme indiqué ci-après.

La signification du champ 4 dépend de la valeur du champ 1 comme indiqué ci-après.

Afficher des boîtes de message

Pour afficher une boîte de message avec des boutons push et des icônes, calculez la valeur de type en ajoutant les styles de boîte de message standards utilisés par MessageBox et MessageBoxEx à msiMessageTypeError, msiMessageTypeWarning ou msiTypeUser. Les options de bouton push disponibles pour VBScript sont vbOKOnly (MB_OK), vbOKCancel (MB_OKCANCEL), vbAbortRetryIgnore (MB_ABORTRETRYIGNORE), vbYesNoCancel (MB_YESNOCANCEL), vbYesNo (MB_YESNO) et vbRetryCancel (MB_RETRYCANCEL). Les options d’icône disponibles pour VBScript sont vbCritical (MB_ICONERROR), vbQuestion (MB_ICONQUESTION), vbExclamation (MB_ICONWARNING) et vbInformation (MB_ICONINFORMATION).

Par exemple, l’appel suivant envoie un message msiMessageTypeError avec l’icône vbExclamation et les boutons vbYesNo.

Session.Message &H01000034, record

Si une action personnalisée appelle la méthode Message , l’action personnalisée doit être en mesure de gérer une annulation par l’utilisateur et doit retourner msiDoActionStatusUserExit.

Configuration requise