UpdateHeapTrace
Diese Funktion aktualisiert eine vorhandene Heapablaufverfolgungssitzung mit einem neuen Satz von PIDs, Stackwalkingereignissen oder anderen ETW-Sitzungsänderungen.
ULONG
WINAPI
UpdateHeapTrace(
_Inout_ PEVENT_TRACE_PROPERTIES Properties,
_In_z_ LPCWSTR wszSessionName,
_In_reads_opt_(cPids) const ULONG Pids[],
_In_ ULONG cPids,
_In_reads_opt_(cStackTracingEventIds) const STACK_TRACING_EVENT_ID StackTracingEventIds[],
_In_ ULONG cStackTracingEventIds
);
Parameter
TraceHandle [out]
Speichert ein Handle für eine Ereignisablaufverfolgungssitzung. Dieser Parameter wird auf 0 (null) festgelegt, wenn das Handle ungültig ist. Dieser Parameter sollte nicht mit dem INVALID_HANDLE_VALUE. Verwenden Sie dieses Handle nicht, wenn die Funktion fehlschlägt.
Eigenschaften [in, out]
Ein Zeiger auf eine EVENT_TRACE_PROPERTIES-Struktur mit aktualisierten Eigenschaften für die Sitzung. Details dazu, welche Member dieser Struktur angegeben werden können, finden Sie EVENT_TRACE_CONTROL_UPDATE ControlTrace-Funktion mit ControlCode.
wszSessionName[in]
Der Name der zu aktualisierenden Heapablaufverfolgungssitzung. Dies sollte der gleiche Name sein, der an StartHeapTrace übergeben wurde.
PiDs [in]
Ein Array von Prozess-IDs zum Aktivieren der Heapablaufverfolgung.
cPids [in, out]
Die Größe des Pids-Arrays.
StackTracingEventIds [in]
Ein Array von STACK_TRACING_EVENT_ID , die angeben, für welche Heapereignisse stack walking aktiviert werden soll. Kann den Wert NULL haben.
cStackTracingEventIds [in]
Die Größe des StackTracingEventIds-Arrays.
Rückgabewert
ERROR_SUCCESS gibt den Erfolg an.
Mögliche Fehlerwerte werden in der folgenden Tabelle beschrieben.
| Fehlerwert | BESCHREIBUNG |
|---|---|
ERROR_ALREADY_EXISTS |
Nur eine einzelne Instanz der Kernelprotokollierung wird auf dem System ausgeführt. Wenn diese Funktion versucht, zu starten, nachdem eine andere Komponente die Kernelprotokollierung gestartet hat, wird dieser Fehler möglicherweise zurückgegeben. |
ERROR_INVALID_FLAGS |
Gibt möglicherweise an, dass in Properties.EnableFlags ungültige Ablaufverfolgungsflags enthalten sind. |
ERROR_OUT_OF_MEMORY |
Weist möglicherweise auf einen Fehler beim Zuordnen von Arbeitsspeicher für EVENT_TRACE_PROPERTIES. |
Wenn die Funktion aus einem anderen Grund als den aufgeführten fehlschlägt, wird ein Systemfehlercode zurückgegeben.
Bemerkungen
Keine