Was sind die Spezifikationszeichenfolgen für das erweiterte WPP-Format?

WPP enthält vordefinierte Formatspezifikationszeichenfolgen, die Sie in Ablaufverfolgungsmeldungen zusätzlich zu den Standardformatzeichenfolgen verwenden können, die für printf definiert sind.

Sie können % ! FLAGS!, %! FUNC! und %! EBENE! Zeichenfolgen in einem Präfix für eine Ablaufverfolgungsnachricht und in allen Ablaufverfolgungsfunktionen oder Makros, z. B. DoTraceMessage.

Sie können die anderen erweiterten Zeichenfolgen in jeder Ablaufverfolgungsfunktion verwenden.

Standardkonfigurationsoptionen für tracewpp

WPP verwendet "defaultwpp.ini" für die Standardkonfigurationseinstellungen. Diese STANDARD-INI-Datei ist als Teil des Windows SDK im Verzeichnis WppConfig Rev1 enthalten. In dieser INI-Datei finden Sie die neuesten Informationen zum WPP-Standardverhalten sowie weitere Informationen zur Anpassung.

Softwareablaufverfolgung

Formatzeichenfolge	BESCHREIBUNG
%! DATEI!	Zeigt den Namen der Quelldatei an, aus der die Ablaufverfolgungsmeldung generiert wurde. Diese Variable kann auch im Präfix der Ablaufverfolgungsnachricht verwendet werden.
%! FLAGGEN!	Zeigt den Wert der Ablaufverfolgungsflags an , die die Ablaufverfolgungsmeldung aktivieren. Diese Variable kann auch im Präfix der Ablaufverfolgungsnachricht verwendet werden.
%! FUNC!	Zeigt die Funktion an, die die Ablaufverfolgungsmeldung generiert hat. Diese Variable kann auch im Präfix der Ablaufverfolgungsnachricht verwendet werden.
%! EBENE!	Zeigt den Namen der Ablaufverfolgungsebene an , die die Ablaufverfolgungsmeldung aktiviert. Diese Variable kann auch im Präfix der Ablaufverfolgungsnachricht verwendet werden.
%! LINIE!	Zeigt die Zeilennummer der Zeile im Code an, die das Ablaufverfolgungspräfix generiert hat. Diese Variable kann auch im Präfix der Ablaufverfolgungsnachricht verwendet werden.

Allgemeine Verwendung

Formatzeichenfolge	BESCHREIBUNG
%!bool!	Zeigt TRUE oder FALSE an.
%!irql!	Zeigt den Namen des aktuellen IRQL an.
%!sid!	Stellt einen Zeiger auf die Sicherheits-ID (pSID) dar. Zeigt die SID an.
GUIDs
%! GUID!	Stellt einen Zeiger auf eine GUID (pGUID) dar. Zeigt die GUID an, auf die verwiesen wird.
%! CLSID!	Klassen-ID. Stellt einen Zeiger auf eine Klassen-ID-GUID dar. Zeigt die der GUID zugeordnete Zeichenfolge an. WPP sucht die Zeichenfolge in der Registrierung, wenn die Ablaufverfolgungsmeldungen formatiert werden.
%! LIBID!	Typbibliothek Stellt die GUID einer COM-Typbibliothek dar. Zeigt die der GUID zugeordnete Zeichenfolge an. WPP sucht die Zeichenfolge in der Registrierung, wenn die Ablaufverfolgungsmeldungen formatiert werden.
%! IID!	Schnittstellen-ID. Stellt einen Zeiger auf eine Schnittstellen-ID-GUID dar. Zeigt die der GUID zugeordnete Zeichenfolge an. WPP sucht die Zeichenfolge in der Registrierung, wenn die Ablaufverfolgungsmeldungen formatiert werden.
Time
%!delta!	Zeigt den Unterschied zwischen zwei Zeitwerten in Millisekunden an. Es handelt sich um einen LONGLONG-Wert, der im Day~h:m:s-Format angezeigt wird.
%! WAITTIME!	Zeigt die Zeit an, die in Millisekunden darauf gewartet wurde, dass etwas abgeschlossen wurde. Es handelt sich um einen LONGLONG-Wert, der im Day~h:m:s-Format angezeigt wird. Entwickelt für die Verwendung mit %!due!.
%!due!	Zeigt die Zeit an, zu der etwas in Millisekunden abgeschlossen werden soll. Es handelt sich um einen LONGLONG-Wert, der im Day~h:m:s-Format angezeigt wird. Für die Verwendung mit %! WAITTIME!.
%! TIMESTAMP! %!datetime! %! ZEIT!	Zeigt den Wert der Systemzeit zu einem bestimmten Zeitpunkt an. Hierbei handelt es sich um LONGLONG-Werte (SINT64), die im SYSTEMTIME-Format angezeigt werden. Sie können diese Variablen verwenden, um unterschiedliche Zeitwerte in Ihrem Programm darzustellen und zwischen ihnen zu unterscheiden.

Rückgabecodes

Formatzeichenfolge	BESCHREIBUNG
%! STATUS!	Stellt einen status Wert dar und zeigt die Zeichenfolge an, die dem status Code zugeordnet ist.
%! WINERROR!	Stellt einen Windows-Fehlercode dar und zeigt die dem Fehler zugeordnete Zeichenfolge an.
%! HRESULT!	Stellt einen Fehler oder eine Warnung dar und zeigt den Code im HRESULT-Format an.

Netzwerk

Formatzeichenfolge	BESCHREIBUNG
%! IPADDR!	Stellt einen Zeiger auf eine IP-Adresse dar. Zeigt die IP-Adresse an.
%! HAFEN!	Zeigt eine Portnummer an.