WIAS_LTRACE Makro (wiautil.h)

Das makro WIAS_LTRACE ist veraltet. Es wird empfohlen, stattdessen das makro WIAS_TRACE zu verwenden.

Das WIAS_LTRACE Makro schreibt eine Diagnosenachricht WIA_TRACE in die Protokolldatei.

Syntax

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

Parameter

x

y

z

params

• DetailLevel : Gibt die Diagnosedetailebene der Nachricht an. Dieser Parameter kann einen der folgenden Werte annehmen.

  Wert	BESCHREIBUNG
  WIALOG_LEVEL1	Protokolliert Ein- und Ausgangspunkte für alle WIA-Methoden und -Funktionen.
  WIALOG_LEVEL2	Protokolliert zusätzliche Details für WIALOG_LEVEL1.
  WIALOG_LEVEL3	Protokolliert Ein- und Ausgangspunkte für alle WIA-Methoden und -Funktionen sowie zusätzliche vom Anbieter bereitgestellte Funktionen.
  WIALOG_LEVEL4	Protokolliert zusätzliche Details für WIALOG_LEVEL3.
  WIALOG_LEVELXXX	Benutzerdefinierte Protokollebenen.

• ResourceID : Gibt die Ressourcen-ID an. Dieser Wert sollte auf WIALOG_NO_RESOURCE_ID festgelegt werden.

• format_string : Gibt eine Variablenargumentliste an, die mit einer ANSI-Formatzeichenfolge beginnt, die die Nachricht und alle Formatbezeichner beschreibt. Die Auslassungspunkte (...) gibt eine variable Anzahl von Argumenten an, die ausgegeben werden müssen. Dem Fehlertext sollte der vollständige Name der Methode oder Funktion vorangestellt sein und die Nachricht im Format "class::method, error-text" generieren.

• pIWiaLog : Zeiger auf eine IWiaLog-Schnittstelle.

Rückgabewert

Keine

Bemerkungen

Im Folgenden finden Sie ein Beispiel für die Verwendung des Makros:

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

Die Verwendung des WIAS_LTRACE Makros wird nicht empfohlen, da die Ausgabe nicht in die Wiatrace.log Diagnoseprotokolldatei aufgezeichnet wird. Es wird empfohlen, stattdessen das makro WIAS_TRACE zu verwenden.

Anforderungen

Weitere Informationen

WIAS_LERROR

WIAS_LHRESULT

WIAS_LWARNING

WIAS_TRACE