traceQueryInformation 函数 (evntrace.h)

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

语法

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

参数

TraceId

[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 和 Windows Server 2012 R2 上的 Sechost.lib;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