getTraceEnableFlags 函数 (evntrace.h)

基于 RegisterTraceGuids 的 (“Classic”) 事件提供程序使用 GetTraceEnableFlags 函数检索跟踪控制器指定的启用标志,以指示要跟踪的事件类别。

提供程序从其 ControlCallback 函数调用此函数。

语法

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACEHANDLE TraceHandle
);

参数

[in] TraceHandle

事件跟踪会话的句柄,通过调用 GetTraceLoggerHandle 函数获取。

返回值

返回调用 EnableTrace 函数时 EnableFlag 参数中指定的控制器的值。

若要确定函数是否失败或控制器将启用标志设置为 0,请执行以下步骤:

  1. 调用 SetLastError 函数,将最后一个错误设置为 ERROR_SUCCESS
  2. 调用 GetTraceEnableFlags 函数以检索启用标志。
  3. 如果 enable flags 值为 0,请调用 GetLastError 函数以检索上一个已知错误。
  4. 如果最后一个已知错误 ERROR_SUCCESS,则控制器将启用标志设置为 0;否则, GetTraceEnableFlags 函数失败并出现上一个已知错误。

注解

提供程序可以使用此值来控制它生成的事件。 例如,提供程序可以将事件分组为事件的逻辑类别,并使用此值启用或禁用其生成。

示例

有关使用 GetTraceEnableFlags 的示例,请参阅 使用 MOF 检索事件数据

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 evntrace.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

GetTraceEnableLevel

GetTraceLoggerHandle