Compartilhar via


Função SetTraceCallback (evntrace.h)

Importante

Não use essa função; ele pode estar indisponível em versões subsequentes. Em vez disso, filtre para a classe de rastreamento de eventos em sua função EventRecordCallback .

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 evento para a qual você deseja receber eventos. Para obter uma lista de GUIDs da classe de provedor de kernel, consulte Constantes de agente do kernel NT.

[in] EventCallback

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

Retornar valor

Se a função obtiver êxito, 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 condições é verdadeira:

    • pGuid é NULL.
    • EventCallback é NULL.

Comentários

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 evento, 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho evntrace.h
Biblioteca Sechost.lib em Windows 8.1 e Windows Server 2012 R2; Advapi32.lib em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP
DLL Sechost.dll em Windows 8.1 e Windows Server 2012 R2; Advapi32.dll em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP

Confira também

EventCallback

ProcessTrace

RemoveTraceCallback