macro WIAS_LTRACE (wiautil.h)

Article
02/07/2025

La macro WIAS_LTRACE est obsolète. Il est recommandé d’utiliser la macro WIAS_TRACE à la place.

La macro WIAS_LTRACE écrit un message de WIA_TRACE de diagnostic dans le fichier journal.

Syntaxe

void WIAS_LTRACE(
   x,
   y,
   z,
   params
);

Paramètres

x

y

z

params

DetailLevel : spécifie le niveau de détail de diagnostic du message. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Description
WIALOG_LEVEL1	Enregistre les points d’entrée et de sortie pour toutes les méthodes et fonctions WIA.
WIALOG_LEVEL2	Enregistre des détails supplémentaires pour WIALOG_LEVEL1.
WIALOG_LEVEL3	Consigne les points d’entrée et de sortie pour toutes les fonctions et méthodes WIA et les fonctions supplémentaires fournies par le fournisseur.
WIALOG_LEVEL4	Enregistre des détails supplémentaires pour WIALOG_LEVEL3.
WIALOG_LEVELXXX	Niveaux de journal définis par l’utilisateur.

ResourceID : spécifie l’ID de ressource. Cette valeur doit être définie sur WIALOG_NO_RESOURCE_ID.
format_string : spécifie une liste d’arguments variables, qui commence par une chaîne de format ANSI décrivant le message et tous les identificateurs de format. Les points de suspension (...) spécifient un nombre variable d’arguments qui doivent être générés. Le texte d’erreur doit être précédé du nom complet de la méthode ou de la fonction et générer le message au format « class ::method, error-text ».
pIWiaLog - Pointeur vers une interface IWiaLog .

Valeur de retour

Aucun

Remarques

Voici un exemple de la façon dont la macro peut être utilisée :

WIAS_LTRACE(g_pIWiaLog, WIALOG_NO_RESOURCE_ID, WIALOG_LEVEL2,
  ("MyClass::MyMethod, This is my text and my lValue = %d", lValue));

L’utilisation de la macro WIAS_LTRACE n’est pas recommandée, car elle n’enregistre pas sa sortie dans le fichier journal de diagnostic Wiatrace.log. Il est recommandé d’utiliser la macro WIAS_TRACE à la place.