GetTraceEnableLevel 函数 (evntrace.h)

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

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

语法

UCHAR WMIAPI GetTraceEnableLevel(
  [in] TRACEHANDLE TraceHandle
);

[in] TraceHandle

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

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

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

调用 SetLastError 函数，将最后一个错误设置为 ERROR_SUCCESS。
调用 GetTraceEnableLevel 函数以检索启用级别。
如果启用级别值为 0，则调用 GetLastError 函数以检索上一个已知错误。
如果上一个已知错误 ERROR_SUCCESS，则控制器将启用级别设置为 0;否则， GetTraceEnableLevel 函数失败并出现上一个已知错误。

提供程序使用此值来控制它生成的事件的严重性。例如，提供程序可以使用此值来确定它应生成信息性、警告或错误事件。

有关使用 GetTraceEnableLevel 的示例，请参阅使用 MOF 检索事件数据。