Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
| 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 unter Windows 8.1 und Windows Server 2012 R2; Advapi32.lib unter Windows 8 und Windows Server 2012 |
| DLL | Sechost.dll unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8 und Windows Server 2012 |