Función OpenTraceA (evntrace.h)

La función OpenTrace abre un identificador de procesamiento de seguimiento ETW para consumir eventos de una sesión de seguimiento en tiempo real de ETW o un archivo de registro ETW.

Sintaxis

PROCESSTRACE_HANDLE WMIAPI OpenTraceA(
  [in, out] PEVENT_TRACE_LOGFILEA Logfile
);

Parámetros

[in, out] Logfile

Puntero a una estructura de EVENT_TRACE_LOGFILE . La estructura especifica el origen del que se van a consumir eventos (de un archivo de registro ETW o de una sesión ETW en tiempo real) y especifica las devoluciones de llamada que el consumidor quiere usar para recibir los eventos. Si se ejecuta correctamente, OpenTrace actualizará la estructura con información del archivo o la sesión abiertos.

Valor devuelto

Si la función se realiza correctamente, devuelve el identificador de procesamiento de seguimiento. El identificador debe cerrarse mediante CloseTrace.

Si se produce un error en la función, devuelve INVALID_PROCESSTRACE_HANDLE. (INVALID_PROCESSTRACE_HANDLE es equivalente a (UINT64)UINTPTR_MAX).

Si se produce un error en la función , puede usar la función GetLastError para obtener información de error extendida. A continuación se muestran algunos errores comunes y sus causas.

• ERROR_INVALID_PARAMETER

  El parámetro Logfile es NULL.

• ERROR_BAD_PATHNAME

  Si no especificó el miembro LoggerName de EVENT_TRACE_LOGFILE, debe especificar un nombre de archivo de registro válido.

• ERROR_ACCESS_DENIED

  Solo los usuarios con privilegios administrativos, los usuarios del grupo Usuarios del registro de rendimiento y los servicios que se ejecutan como LocalSystem, LocalService, NetworkService pueden consumir eventos en tiempo real. Para conceder a un usuario restringido la capacidad de consumir eventos en tiempo real, agréguelos al grupo Usuarios del registro de rendimiento.

  Windows XP y Windows 2000: Cualquier persona puede consumir eventos en tiempo real.

Comentarios

Los consumidores de seguimiento llaman a esta función para abrir una sesión de procesamiento de seguimiento.

Después de llamar a OpenTrace, llame a la función ProcessTrace para procesar los eventos. Cuando haya terminado de procesar eventos, llame a la función CloseTrace para cerrar el identificador de procesamiento de seguimiento.

Ejemplos

Para obtener un ejemplo que usa OpenTrace, consulte Uso de TdhFormatProperty para consumir datos de eventos.

Requisitos

Consulte también

CloseTrace

EVENT_TRACE_LOGFILE

ProcessTrace