getTraceEnableFlags 函数 (evntrace.h)

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

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

语法

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACELOGGER_HANDLE TraceHandle
);

[in] TraceHandle

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

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

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

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

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

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