UpdateHeapTrace
Esta función actualiza una sesión de seguimiento de montón existente con un nuevo conjunto de PID, eventos de stackwalking u otros cambios de sesión 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
);
Parámetros
TraceHandle [out]
Almacena un identificador en una sesión de seguimiento de eventos. Este parámetro se establece en cero si el identificador no es válido. Este parámetro no debe compararse con INVALID_HANDLE_VALUE. No use este identificador si se produce un error en la función.
Propiedades [in, out]
Puntero a una estructura de EVENT_TRACE_PROPERTIES con propiedades actualizadas para la sesión. Consulte la función ControlTrace con controlCode EVENT_TRACE_CONTROL_UPDATE para obtener más información sobre qué miembros de esta estructura se pueden especificar.
wszSessionName[in]
Nombre de la sesión de seguimiento del montón que se va a actualizar. Debe ser el mismo nombre que se pasó a StartHeapTrace.
Pids [in]
Matriz de identificadores de proceso para habilitar el seguimiento del montón.
cPids [in, out]
Tamaño de la matriz Pids.
StackTracingEventIds [in]
Matriz de estructuras de STACK_TRACING_EVENT_ID que especifican para qué pila de eventos de montón debe habilitarse. Puede ser NULL.
cStackTracingEventIds [in]
Tamaño de la matriz StackTracingEventIds.
Valor devuelto
ERROR_SUCCESS indica que se ha realizado correctamente.
Los valores de error posibles se describen en la tabla siguiente.
| Valor de error | Descripción |
|---|---|
ERROR_ALREADY_EXISTS |
Solo se ejecuta una sola instancia del registrador de kernel en el sistema. Si esta función intenta iniciarse después de que otro componente haya iniciado el registro del kernel, es posible que se devuelva este error. |
ERROR_INVALID_FLAGS |
Posiblemente indica que hay marcas de seguimiento no válidas en Properties.EnableFlags. |
ERROR_OUT_OF_MEMORY |
Posiblemente indica un error al asignar memoria para EVENT_TRACE_PROPERTIES. |
Si se produce un error en la función por un motivo distinto de los enumerados, se devuelve un código de error del sistema.
Observaciones
Ninguno