UpdateHeapTrace

Эта функция обновляет существующий сеанс трассировки кучи с помощью нового набора ИДЕНТИФИКАТОРов, событий стека или других изменений сеанса трассировки событий Windows.

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. Не используйте этот дескриптор, если функция завершается сбоем.

Свойства [вход, выход]
Указатель на структуру EVENT_TRACE_PROPERTIES с обновленными свойствами сеанса. Дополнительные сведения о том, какие элементы этой структуры можно указать, см. в разделе Функция ControlTrace с EVENT_TRACE_CONTROL_UPDATE ControlCode.

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.

Если функция завершается сбоем по причине, отличной от перечисленных, возвращается код системной ошибки.

Remarks

None

Связанные темы

Функции

StartHeapTrace