TraceSetInformation-Funktion (evntrace.h)

  • Artikel

Die TraceSetInformation-Funktion konfiguriert Sitzungseinstellungen für die Ereignisablaufverfolgung.

Syntax

ULONG WMIAPI TraceSetInformation(
  [in] TRACEHANDLE      SessionHandle,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Parameter

[in] SessionHandle

Handle der zu konfigurierenden Ereignisablaufverfolgungssitzung. 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 zu aktivierende oder zu deaktivierende Informationsklasse. Die Von der -Klasse erfassten Informationen sind im Abschnitt "Erweiterte Daten" 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 informationenklassenspezifische Daten. Die Informationsklasse bestimmt den Inhalt dieses Parameters.

[in] InformationLength

Die Größe der Daten im Puffer TraceInformation in Bytes.

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

Rufen Sie diese Funktion nach dem Aufruf von StartTrace auf.

Wenn der Parameter InformationClass auf TraceStackTracingInfo festgelegt ist, aktiviert 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 auf, wobei InformationClass auf TraceStackTracingInfo und InformationLength auf 0 festgelegt ist.

Der Abschnitt für erweiterte Daten des Ereignisses enthält den Aufrufstapel. Die StackWalk_Event MOF-Klasse definiert das Layout der erweiterten Daten.

In der Regel können Sie auf 64-Bit-Computern den Kernelstapel in bestimmten Kontexten nicht erfassen, wenn Seitenfehler nicht zulässig sind. Um das Durchlaufen des Kernelstapels auf x64 zu aktivieren, legen Sie den Registrierungswert der 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 dadurch die Arbeitsspeicherauslastung 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 unter 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 unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8, Windows Server 2012, Windows 7 und Windows Server 2008 R2

Weitere Informationen

TRACE_QUERY_INFO_CLASS

TraceQueryInformation