UpdateHeapTrace
Diese Funktion aktualisiert eine vorhandene Heapablaufverfolgungssitzung mit neuen PIDs, Stackwalk-Ereignissen 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 Null gesetzt, wenn das Handle nicht gültig ist. Dieser Parameter sollte nicht mit INVALID_HANDLE_VALUE verglichen werden. Verwenden Sie dieses Handle nicht, wenn die Funktion fehlschlägt.
Properties [in, out]
Ein Zeiger auf eine EVENT_TRACE_PROPERTIES-Struktur mit aktualisierten Eigenschaften für die Sitzung. Weitere Informationen zu den Elementen dieser Struktur, die Sie angeben können, finden Sie in der ControlTrace-Funktion mit dem Steuerungscode EVENT_TRACE_CONTROL_UPDATE.
wszSessionName[in]
Der Name der zu aktualisierenden Heapablaufverfolgungssitzung. Dieser sollte mit dem Namen identisch sein, der an StartHeapTrace übergeben wurde.
Pids [in]
Ein Array von Prozess-IDs zum Aktivieren der Heap-Ablaufverfolgung.
cPids [in, out]
Die Größe des Pids-Arrays.
StackTracingEventIds [in]
Ein Array von STACK_TRACING_EVENT_ID-Strukturen, das angibt, für welche Heapereignisse Stackwalks aktiviert werden sollen. Kann den Wert NULL haben.
cStackTracingEventIds [in]
Die Größe des StackTracingEventIds-Arrays.
Rückgabewert
ERROR_SUCCESS zeigt Erfolg an.
Mögliche Fehlerwerte sind in der folgenden Tabelle beschrieben.
| Fehlerwert | Beschreibung |
|---|---|
ERROR_ALREADY_EXISTS |
Auf dem System läuft nur eine einzige Instanz des Kernel-Loggers. Wenn diese Funktion zu starten versucht, nachdem eine andere Komponente die Kernel-Protokollierung gestartet hat, wird möglicherweise dieser Fehler zurückgegeben. |
ERROR_INVALID_FLAGS |
Zeigt möglicherweise an, dass ungültige Ablaufverfolgungsflags in Properties.EnableFlags vorhanden sind. |
ERROR_OUT_OF_MEMORY |
Zeigt möglicherweise einen Fehler beim Zuweisen von Speicher für EVENT_TRACE_PROPERTIES an. |
Wenn die Funktion aus einem anderen als den aufgeführten Gründen fehlschlägt, wird ein Systemfehlercode zurückgegeben.
Bemerkungen
Keine