Función TraceQueryInformation (evntrace.h)

La función TraceQueryInformation proporciona información sobre una sesión de seguimiento de eventos.

Sintaxis

ULONG WMIAPI TraceQueryInformation(
  [in]            TRACEHANDLE      SessionHandle,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

Parámetros

[in] SessionHandle

Identificador de la sesión de seguimiento de eventos para la que va a recopilar información. La función StartTrace devuelve este identificador cuando se inicia un nuevo seguimiento. Para obtener el identificador de un seguimiento existente, use ControlTrace para consultar las propiedades de seguimiento en función del nombre del seguimiento y, a continuación, obtener el identificador del campo Wnode.HistoricalContext de los datos devueltos EVENT_TRACE_PROPERTIES .

[in] InformationClass

Clase de información que se va a consultar. La información que captura la clase se incluye en la sección de datos extendidos del evento. Para obtener una lista de las clases de información que puede consultar, vea la enumeración TRACE_QUERY_INFO_CLASS .

[out] TraceInformation

Puntero a un búfer para recibir los datos específicos de la clase de información devuelta. La clase de información determina el contenido de este parámetro. Por ejemplo, para la clase de información TraceStackTracingInfo , este parámetro es una matriz de estructuras CLASSIC_EVENT_ID . Las estructuras especifican los GUID de eventos para los que está habilitado el seguimiento de la pila. La matriz está limitada a 256 elementos.

[in] InformationLength

Tamaño, en bytes, de los datos devueltos en el búfer TraceInformation . Si se produce un error en la función, este valor indica el tamaño necesario del búfer TraceInformation que se necesita.

[out, optional] ReturnLength

Puntero a un valor que recibe el tamaño, en bytes, de los datos específicos devueltos en el búfer TraceInformation .

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 siguientes códigos de error.

• ERROR_BAD_LENGTH

  El programa lanzó un comando pero la longitud del comando es incorrecta. Este error se devuelve si el parámetro InformationLength es menor que un tamaño mínimo.

• ERROR_INVALID_PARAMETER

  El parámetro no es correcto.

• ERROR_NOT_SUPPORTED

  No se admite la solicitud.

• Otros

  Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

La función TraceQueryInformation consulta la configuración de la sesión de seguimiento de eventos desde una sesión de seguimiento. Llame a esta función después de llamar a StartTrace.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [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 y Windows Server 2012
Archivo DLL	Sechost.dll en Windows 8.1 y Windows Server 2012 R2; Advapi32.dll en Windows 8 y Windows Server 2012

Consulte también

TRACE_QUERY_INFO_CLASS

TraceSetInformation