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