TraceLoggingBinary-Makro (traceloggingprovider.h)

Artikel
08/26/2023

TraceLogging-Wrappermakro , das dem Ereignis ein Feld mit Binärdaten hinzufügt.

Syntax

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

Parameter

[in] pValue

Ein Zeiger auf die Daten, die in das Ereignis eingeschlossen werden sollen.

[in] cbValue

Die Größe der Daten, die in das Ereignis eingeschlossen werden sollen, in Bytes.

[in, optional] __VA_ARGS__

Optionale Name-, Beschreibungs- und Tagsparameter für die Felddefinition.

TraceLoggingBinary kann mit 2, 3, 4 oder 5 Parametern angegeben werden. Wenn kein optionaler Parameter angegeben wird, wird ein Standardwert verwendet. TraceLoggingBinary(&x.data, sizeof(x.data)) entspricht beispielsweise TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0).

[in, optional] name

Der Name, der für das Ereignisfeld verwendet werden soll. Falls angegeben, muss der name-Parameter ein Zeichenfolgenliteral (keine Variable) sein und darf keine "\0"-Zeichen enthalten. Wenn nicht angegeben, basiert der Name des Ereignisfelds auf pValue.
[in, optional] description

Die Beschreibung des Werts des Ereignisfelds. Falls angegeben, muss der description-Parameter ein Zeichenfolgenliteral sein und im PDB enthalten sein.
[in, optional] tags

Ein konstanter ganzzahliger Wert für die Kompilierzeit. Die niedrigen 28 Bits des Werts werden in die Metadaten des Felds aufgenommen. Die Semantik dieses Werts wird vom Ereignisconsumer definiert. Während der Ereignisverarbeitung kann dieser Wert aus dem Feld EVENT_PROPERTY_INFO Tags abgerufen werden.

Rückgabewert

Keine

Bemerkungen

TraceLoggingBinary(pValue, cbValue, ...) kann als Parameter für einen Aufruf eines TraceLoggingWrite-Makros verwendet werden. Jeder TraceLoggingBinary-Parameter fügt dem Ereignis ein Feld hinzu.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	traceloggingprovider.h

Weitere Informationen

TraceLoggingWrite

TraceLogging-Wrappermakros

Freigeben über