WIAS_LTRACE-Makro (wiamdef.h)

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

Das WIAS_LTRACE Makro schreibt eine Diagnosemeldung WIA_TRACE in die Protokolldatei.

Syntax

void WIAS_LTRACE(
   pILog,
   ResID,
   Detail,
   Args
);

Parameter

pILog

ResID

Detail

Args

  • 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 werden und die Meldung im Format "class::method, error-text" generiert werden.

  • 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));

Das WIAS_LTRACE Makro veraltet und wird nicht zur Verwendung 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 wiamdef.h (wiautil.h einschließen)

Weitere Informationen

WIAS_LERROR

WIAS_LHRESULT

WIAS_LWARNING

WIAS_TRACE