WIAS_LTRACE-Makro (wiamdef.h)

Artikel
02/29/2024

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

Freigeben über