Función SetTraceCallback (evntrace.h)

Importante

No utilice esta función; puede no estar disponible en versiones posteriores. En su lugar, filtre por la clase de seguimiento de eventos en la función EventRecordCallback .

La función SetTraceCallback especifica una función EventCallback para procesar eventos para la clase de seguimiento de eventos especificada.

Sintaxis

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

Parámetros

[in] pGuid

Puntero al GUID de clase de una clase de seguimiento de eventos para la que desea recibir eventos. Para obtener una lista de los GUID de clase del proveedor de kernel, consulte Constantes de registrador de kernel nt.

[in] EventCallback

Puntero a una función EventCallback que se usa para procesar eventos pertenecientes a la clase de seguimiento de eventos.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es uno de los códigos de error del sistema. A continuación se muestran algunos errores comunes y sus causas.

• ERROR_INVALID_PARAMETER

  Una de las siguientes condiciones se cumple:

  • pGuid es NULL.
  • EventCallback es NULL.

Comentarios

Los consumidores llaman a esta función.

Solo puede especificar una función de devolución de llamada para una clase de seguimiento de eventos. Si especifica más de una función de devolución de llamada para la clase de seguimiento de eventos, la última función de devolución de llamada recibe los eventos de esa clase de seguimiento de eventos.

Para impedir que la función de devolución de llamada reciba eventos para la clase de seguimiento de eventos, llame a la función RemoveTraceCallback . La devolución de llamada deja de recibir automáticamente devoluciones de llamada al cerrar el seguimiento.

Puede usar esta función para recibir eventos escritos mediante una de las funciones TraceEvent . No puede usar esta función para consumir eventos de un proveedor que usó una de las funciones EventWrite para registrar eventos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	evntrace.h
Library	Sechost.lib en Windows 8.1 y Windows Server 2012 R2; Advapi32.lib en Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista y Windows XP
Archivo DLL	Sechost.dll en Windows 8.1 y Windows Server 2012 R2; Advapi32.dll en Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista y Windows XP

Consulte también

EventCallback

ProcessTrace

RemoveTraceCallback