TraceQueryInformation-Funktion (evntrace.h)

Die TraceQueryInformation-Funktion stellt Informationen zu einer Ereignisablaufverfolgungssitzung bereit.

Syntax

ULONG WMIAPI TraceQueryInformation(
                  CONTROLTRACE_ID  TraceId,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

Parameter

TraceId

[in] InformationClass

Die abzufragende Informationsklasse. Die Von der -Klasse erfassten Informationen sind im Abschnitt "Erweiterte Daten" des Ereignisses enthalten. Eine Liste der Informationsklassen, die Sie abfragen können, finden Sie in der TRACE_QUERY_INFO_CLASS-Enumeration .

[out] TraceInformation

Ein Zeiger auf einen Puffer zum Empfangen der zurückgegebenen Informationsklassenspezifischen Daten. Die Informationsklasse bestimmt den Inhalt dieses Parameters. Für die TraceStackTracingInfo-Informationsklasse ist dieser Parameter beispielsweise ein Array von CLASSIC_EVENT_ID Strukturen. Die Strukturen geben die Ereignis-GUIDs an, für die die Stapelablaufverfolgung aktiviert ist. Das Array ist auf 256 Elemente beschränkt.

[in] InformationLength

Die Größe der im TraceInformation-Puffer zurückgegebenen Daten in Bytes. Wenn die Funktion fehlschlägt, gibt dieser Wert die erforderliche Größe des TraceInformation-Puffers an, der benötigt wird.

[out, optional] ReturnLength

Ein Zeiger eines Werts, der die Größe der im TraceInformation-Puffer zurückgegebenen spezifischen Daten in Bytes empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

• ERROR_BAD_LENGTH

  Das Programm hat einen Befehl ausgegeben, aber die Befehlslänge ist falsch. Dieser Fehler wird zurückgegeben, wenn der InformationLength-Parameter kleiner als eine Mindestgröße ist.

• ERROR_INVALID_PARAMETER

  „Der Parameter ist falsch.“

• ERROR_NOT_SUPPORTED

  Die Anforderung wird nicht unterstützt.

• Andere

  Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die TraceQueryInformation-Funktion fragt Ereignisablaufverfolgungssitzungseinstellungen aus einer Ablaufverfolgungssitzung ab. Rufen Sie diese Funktion nach dem Aufruf von StartTrace auf.

Anforderungen

Weitere Informationen

TRACE_QUERY_INFO_CLASS

TraceSetInformation