Cette fonction permet d'enregistrer un événement dans le journal d'événements Windows (section Application).
Domaine d'application
Client Windows,
Serveur Windows.
Paramètres
ALPHA(n) |
SrcAppName |
Nom de l'application générant l'événement. |
ALPHA(n) |
ErrMessFile |
Nom de la DLL de messages d'erreur. Si ce paramètre contient uniquement le nom de la DLL, un chemin complet est construit. Ce chemin est sauvegardé lors de l'enregistrement de l'événement, et utilisé par le journal d'événements Windows pour retrouver le libellé de l'événement. La construction du chemin de la DLL s'appuie sur la recherche standard Windows d'un fichier, dans l'ordre suivant :
|
NUM_BIN_4 |
ErrType |
Type de l'erreur (ERROR = 1; WARNING = 2;INFORMATION = 4) |
NUM_BIN_4 |
Cat |
Catégorie de l'événement. |
NUM_BIN_4 |
EventID |
Numéro interne du message dans la DLL de message ErrMessFile (utiliser la fonction VaToolBxGetAdeliaMsgId pour récupérer ce numéro à partir des informations d'un message Adélia). |
ALPHA(n) |
VarMsg |
Variable pour le message (*BLANK si aucune variable demandée par le message ; au plus une variable peut être renseignée). |
BOOL |
OK |
Retourne *VRAI si l'événement a pu être enregistré. |
Par exemple
APPELER_DLL 'VaToolBx' 'VaToolBxRegisterEvent' 'MonAppIWS' 'ERRMSG' 1 0 NumIntMsg 'Nom' OK
Enregistre, dans le journal des événements Windows dans la section Application pour l'application 'MonAppIWS', le message d'ID NumIntMsg se trouvant dans le fichier 'ERRMSG.dll'. Ce message contient une variable (&1) qui est remplacée par la chaîne 'Nom'.
