Função SetTraceCallback (evntrace.h)

A função SetTraceCallback especifica uma função EventCallback para processar eventos para a classe de rastreamento de evento especificada.

Sintaxe

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

Parâmetros

[in] pGuid

Ponteiro para o GUID de classe de uma classe de rastreamento de eventos para a qual você deseja receber eventos. Para obter uma lista de GUIDs da classe de provedor de kernel, consulte NT Kernel Logger Constants.

[in] EventCallback

Ponteiro para uma função EventCallback usada para processar eventos pertencentes à classe de rastreamento de eventos.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos códigos de erro do sistema. Veja a seguir alguns erros comuns e suas causas.

• ERROR_INVALID_PARAMETER

  Uma das seguintes opções for verdadeira:

  • pGuid é NULL.
  • EventCallback é NULL.

Observações

Os consumidores chamam essa função.

Você só pode especificar uma função de retorno de chamada para uma classe de rastreamento de evento. Se você especificar mais de uma função de retorno de chamada para a classe de rastreamento de eventos, a última função de retorno de chamada receberá os eventos dessa classe de rastreamento de evento.

Para impedir que a função de retorno de chamada receba eventos para a classe de rastreamento de eventos, chame a função RemoveTraceCallback . O retorno de chamada interrompe automaticamente o recebimento de retornos de chamada quando você fecha o rastreamento.

Você pode usar essa função para receber eventos gravados usando uma das funções TraceEvent . Você não pode usar essa função para consumir eventos de um provedor que usou uma das funções EventWrite para registrar eventos em log.

Requirements

Consulte também

EventCallback

ProcessTrace

RemoveTraceCallback