TraceSetInformation-Funktion (evntrace.h)
Die TraceSetInformation-Funktion konfiguriert Die Ereignisablaufverfolgungssitzungseinstellungen.
Syntax
ULONG WMIAPI TraceSetInformation(
[in] TRACEHANDLE SessionHandle,
[in] TRACE_INFO_CLASS InformationClass,
[in] PVOID TraceInformation,
[in] ULONG InformationLength
);
Parameter
[in] SessionHandle
Behandeln der Ereignisablaufverfolgungssitzung, die konfiguriert werden soll. Die StartTrace-Funktion gibt diesen Handle zurück, wenn eine neue Ablaufverfolgung gestartet wird. Zum Abrufen des Handles einer vorhandenen Ablaufverfolgung 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 Informationsklasse, die aktiviert oder deaktiviert werden soll. Die Informationen, die die Klasse erfasst, sind im Erweiterten Datenabschnitt des Ereignisses enthalten. Eine Liste der informationsklassen, die Sie aktivieren können, finden Sie in der TRACE_QUERY_INFO_CLASS Enumeration.
[in] TraceInformation
Ein Zeiger auf informationen klassenspezifische Daten. Die Informationsklasse bestimmt den Inhalt dieses Parameters.
[in] InformationLength
Die Größe der Daten im TraceInformation-Puffer in Bytes.
Rückgabewert
Wenn die Funktion erfolgreich verläuft, 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.
Hinweise
Rufen Sie diese Funktion nach dem Aufrufen von StartTrace auf.
Wenn der Parameter InformationClass auf TraceStackTracingInfo festgelegt ist, ermöglicht das Aufrufen dieser Funktion die Stapelablaufverfolgung der angegebenen Kernelereignisse. Nachfolgende Aufrufe dieser Funktion überschreiben die vorherige Liste der Kernelereignisse, für die die Stapelablaufverfolgung aktiviert ist. Um die Stapelablaufverfolgung zu deaktivieren, rufen Sie diese Funktion mit "InformationClass " auf "TraceStackTracingInfo " und " InformationLength " auf "0" auf.
Der erweiterte Datenabschnitt des Ereignisses enthält den Aufrufstapel. Die StackWalk_Event MOF-Klasse definiert das Layout der erweiterten Daten.
Normalerweise können Sie auf 64-Bit-Computern den Kernelstapel in bestimmten Kontexten nicht erfassen, wenn Seitenfehler nicht zulässig sind. Wenn Sie das Walken des Kernelstapels auf x64 aktivieren möchten, legen Sie den Registrierungswert für die DisablePagingExecutive Speicherverwaltung auf 1 fest. Der DisablePagingExecutive Registrierungswert befindet sich unter dem folgenden Registrierungsschlüssel: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management
Dies sollte nur für temporäre Diagnosezwecke erfolgen, da die Speicherauslastung des Systems erhöht wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | evntrace.h |
| Bibliothek | Sechost.lib auf Windows 8.1 und Windows Server 2012 R2; Advapi32.lib unter Windows 8, Windows Server 2012, Windows 7 und Windows Server 2008 R2 |
| DLL | Sechost.dll auf Windows 8.1 und Windows Server 2012 R2; Advapi32.dll auf Windows 8, Windows Server 2012, Windows 7 und Windows Server 2008 R2 |