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

Die Parameter

TraceId

[in] InformationClass

Die zu abfragende Informationsklasse. Die Informationen, die die Klasse erfasst, sind im Erweiterten Datenabschnitt 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, um die zurückgegebenen Informationsklassen spezifischen Daten zu empfangen. 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 Byte 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, die Befehlslänge ist jedoch falsch. Dieser Fehler wird zurückgegeben, wenn der Parameter InformationLength 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.

Bemerkungen

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

Anforderungen

Siehe auch

TRACE_QUERY_INFO_CLASS

TraceSetInformation