UpdateHeapTrace

Essa função atualiza uma sessão de rastreamento de heap existente com um novo conjunto de PIDs, eventos de stackwalking ou outras alterações de sessão 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]
Armazena um identificador em uma sessão de rastreamento de eventos. Esse parâmetro será definido como zero se o identificador não for válido. Esse parâmetro não deve ser comparado a INVALID_HANDLE_VALUE. Não use esse identificador se a função falhar.

Propriedades [in, out]
Um ponteiro para uma estrutura EVENT_TRACE_PROPERTIES com propriedades atualizadas para a sessão. Consulte a função ControlTrace com ControlCode EVENT_TRACE_CONTROL_UPDATE para obter detalhes sobre quais membros dessa estrutura podem ser especificados.

wszSessionName[in]
O nome da sessão de rastreamento de heap a ser atualizada. Esse deve ser o mesmo nome que foi passado para StartHeapTrace.

Pids [in]
Uma matriz de IDs de processo para habilitar o rastreamento de heap.

cPids [in, out]
O tamanho da matriz Pids.

StackTracingEventIds [in]
Uma matriz de estruturas STACK_TRACING_EVENT_ID especificando para quais eventos de heap a movimentação da pilha deve ser habilitada. Pode ser NULL.

cStackTracingEventIds [in]
O tamanho da matriz StackTracingEventIds.

Valor Retornado

ERROR_SUCCESS indica êxito.

Possíveis valores de erro são descritos na tabela a seguir.

Valor do erro Descrição

ERROR_ALREADY_EXISTS

Somente uma única instância do agente de kernel é executada no sistema. Se essa função tentar iniciar depois que outro componente tiver iniciado o registro em log do kernel, esse erro possivelmente será retornado.

ERROR_INVALID_FLAGS

Possivelmente indica que há sinalizadores de rastreamento inválidos em Properties.EnableFlags.

ERROR_OUT_OF_MEMORY

Possivelmente indica falha ao alocar memória para EVENT_TRACE_PROPERTIES.

Se a função falhar por um motivo diferente daqueles listados, um código de erro do sistema será retornado.

Comentários

Nenhum

Funções

StartHeapTrace

  • Last updated on