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