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 |