TraceQueryInformation 函数 (evntrace.h)

  • 项目

TraceQueryInformation 函数提供有关事件跟踪会话的信息。

语法

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

参数

[in] SessionHandle

要为其收集信息的事件跟踪会话的句柄。 启动新跟踪时 ，StartTrace 函数将返回此句柄。 若要获取现有跟踪的句柄，请使用 ControlTrace 根据跟踪的名称查询跟踪属性，然后从返回EVENT_TRACE_PROPERTIES数据的 Wnode.HistoricalContext 字段获取句柄。

[in] InformationClass

要查询的信息类。 类捕获的信息包含在事件的扩展数据部分中。 有关可查询的信息类的列表，请参阅 TRACE_QUERY_INFO_CLASS 枚举。

[out] TraceInformation

指向缓冲区的指针，用于接收返回的信息类特定数据。 信息类确定此参数的内容。 例如，对于 TraceStackTracingInfo 信息类，此参数是 CLASSIC_EVENT_ID 结构的数组。 结构指定为其启用堆栈跟踪的事件 GUID。 数组限制为 256 个元素。

[in] InformationLength

TraceInformation 缓冲区中返回的数据的大小（以字节为单位）。 如果函数失败，此值指示所需的 TraceInformation 缓冲区所需的大小。

[out, optional] ReturnLength

一个指针，一个值，该值接收 TraceInformation 缓冲区中返回的特定数据的大小（以字节为单位）。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值为以下错误代码之一。

  • ERROR_BAD_LENGTH

    程序发出命令，但命令长度不正确。 如果 InformationLength 参数小于最小大小，则返回此错误。

  • ERROR_INVALID_PARAMETER

    参数不正确。

  • ERROR_NOT_SUPPORTED

    不支持该请求。

  • 其他

    使用 FormatMessage 获取返回错误的消息字符串。

注解

TraceQueryInformation 函数从跟踪会话中查询事件跟踪会话设置。 调用 StartTrace 后调用此函数。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 evntrace.h
Library Windows 8.1 上的 Sechost.lib 和 Windows Server 2012 R2;Windows 8 和 Windows Server 2012 上的 Advapi32.lib
DLL Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.dll;Windows 8 和 Windows Server 2012 上的 Advapi32.dll

另请参阅

TRACE_QUERY_INFO_CLASS

TraceSetInformation