TraceQueryInformation-Funktion (evntrace.h)

  • Artikel

Die TraceQueryInformation-Funktion stellt Informationen zu einer Ereignisablaufverfolgungssitzung bereit.

Syntax

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

Parameter

[in] SessionHandle

Handle der Ereignisablaufverfolgungssitzung, für die Sie Informationen sammeln. Die StartTrace-Funktion gibt dieses Handle zurück, wenn eine neue Ablaufverfolgung gestartet wird. Um das Handle einer vorhandenen Ablaufverfolgung abzurufen, verwenden Sie ControlTrace , um die Ablaufverfolgungseigenschaften basierend auf dem Namen der Ablaufverfolgung abzufragen und dann das Handle aus dem Wnode.HistoricalContext-Feld der zurückgegebenen EVENT_TRACE_PROPERTIES Daten abzurufen.

[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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile evntrace.h
Bibliothek Sechost.lib auf Windows 8.1 und Windows Server 2012 R2; Advapi32.lib auf Windows 8 und Windows Server 2012
DLL Sechost.dll auf Windows 8.1 und Windows Server 2012 R2; Advapi32.dll auf Windows 8 und Windows Server 2012

Weitere Informationen

TRACE_QUERY_INFO_CLASS

TraceSetInformation