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 |