Función QueryTraceA (evntrace.h)

La función QueryTrace recupera la configuración de propiedades y las estadísticas de sesión para la sesión de seguimiento de eventos especificada.

Esta función está obsoleta. La función ControlTrace sustituye a esta función.

Sintaxis

ULONG WMIAPI QueryTraceA(
  CONTROLTRACE_ID         TraceId,
  LPCSTR                  InstanceName,
  PEVENT_TRACE_PROPERTIES Properties
);

Parámetros

TraceId

InstanceName

Nombre de la sesión de seguimiento de eventos que se va a consultar o NULL. Debe especificar InstanceName si TraceHandle es 0.

Para especificar la sesión del registrador de kernel nt, establezca InstanceNameen KERNEL_LOGGER_NAME.

Properties

Puntero a una estructura de EVENT_TRACE_PROPERTIES inicializada.

Solo tiene que establecer el miembro Wnode.BufferSize de la estructura EVENT_TRACE_PROPERTIES . Puede usar el nombre de sesión máximo (1024 caracteres) y las longitudes máximas de nombre de archivo de registro (1024 caracteres) para calcular el tamaño y los desplazamientos del búfer si no se conocen.

En la salida, los miembros de la estructura contienen la configuración de propiedades y las estadísticas de sesión de la sesión de seguimiento de eventos.

A partir de Windows 10, versión 1703: Para mejorar el rendimiento en escenarios entre procesos, ahora puede pasar el filtrado a QueryTrace para registradores privados de todo el sistema. Deberá pasar la nueva estructura de EVENT_TRACE_PROPERTIES_V2 para incluir información de filtrado. Consulte Configuración e inicio de una sesión de registrador privado para obtener más información.

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_BAD_LENGTH

  Una de las siguientes condiciones se cumple:

  • El miembro Wnode.BufferSize de Properties especifica un tamaño incorrecto.
  • Las propiedades no tienen espacio suficiente asignado para contener una copia del nombre de la sesión y el nombre del archivo de registro (si se usa).

• ERROR_INVALID_PARAMETER

  Una de las siguientes condiciones se cumple:

  • Las propiedades son NULL.
  • InstanceName y TraceHandle son NULL.
  • InstanceName es NULL y TraceHandle no es un identificador válido.

• ERROR_ACCESS_DENIED

  Solo los usuarios que se ejecutan con privilegios administrativos elevados, los usuarios del grupo Usuarios del registro de rendimiento y los servicios que se ejecutan como LocalSystem, LocalService, NetworkService pueden consultar las sesiones de seguimiento de eventos. Para conceder a un usuario restringido la capacidad de consultar sesiones de seguimiento, agréguelas al grupo Usuarios del registro de rendimiento o vea EventAccessControl.

  Windows XP y Windows 2000: Cualquier persona puede controlar una sesión de seguimiento.

• ERROR_WMI_INSTANCE_NOT_FOUND

  La sesión especificada no se está ejecutando.

Comentarios

Los controladores de seguimiento de eventos llaman a esta función.

Esta función está obsoleta. En su lugar, use ControlTrace con ControlCode establecido en EVENT_TRACE_CONTROL_QUERY.

Requisitos

Consulte también

ControlTrace

QueryAllTraces