UpdateHeapTrace

  • 發行項

此函式會使用一組新的 PID、堆疊活動或其他 ETW 會話變更來更新現有的堆積追蹤會話。

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
    );

參數

TraceHandle [out]
儲存事件追蹤會話的控制碼。 如果控制碼無效，此參數會設定為零。 此參數不應與INVALID_HANDLE_VALUE進行比較。 如果函式失敗，請勿使用此控制碼。

屬性 [in， out]
具有會話已更新屬性 之EVENT_TRACE_PROPERTIES 結構的指標。 如需可指定此結構成員的詳細資訊，請參閱 ControlTrace 函式與 ControlCode EVENT_TRACE_CONTROL_UPDATE。

wszSessionName[in]
要更新的堆積追蹤會話名稱。 這應該是傳遞至 StartHeapTrace 的相同名稱。

Pids [in]
要啟用堆積追蹤的進程識別碼陣列。

cPids [in， out]
Pids 陣列的大小。

StackTracingEventIds [in]
STACK_TRACING_EVENT_ID結構的陣列，指定應啟用哪些堆積事件堆疊逐步執行。 可以是 NULL。

cStackTracingEventIds [in]
StackTracingEventIds 陣列的大小。

傳回值

ERROR_SUCCESS表示成功。

下表說明可能的錯誤值。

錯誤值 描述

ERROR_ALREADY_EXISTS

只有核心記錄器的單一實例會在系統上執行。 如果此函式嘗試在另一個元件啟動核心記錄之後啟動，可能會傳回此錯誤。

ERROR_INVALID_FLAGS

可能表示 Properties.EnableFlags中有不正確追蹤旗標。

ERROR_OUT_OF_MEMORY

可能表示無法為EVENT_TRACE_PROPERTIES配置記憶體。

如果函式因列出的原因而失敗，則會傳回系統錯誤碼。

備註

None

函式

StartHeapTrace