Freigeben über


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

Anforderung Wert
Unterstützte Mindestversion (Client) Veraltet. Verwenden Sie stattdessen WIAS_TRACE.
Zielplattform Desktop
Kopfzeile wiautil.h (einschließlich Wiautil.h)

Weitere Informationen

WIAS_LERROR

WIAS_LHRESULT

WIAS_LWARNING

WIAS_TRACE