Share via

GetTraceEnableFlags 函式 (evntrace.h)

  • 發行項

RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 GetTraceEnableFlags 函式來擷取追蹤控制器所指定的啟用旗標，以指出要追蹤的事件類別。

提供者會從其 ControlCallback 函式呼叫此函式。

語法

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACEHANDLE TraceHandle
);

參數

[in] TraceHandle

呼叫 GetTraceLoggerHandle 函式取得的事件追蹤會話句柄。

傳回值

傳回呼叫 EnableTrace 函式時，EnableFlag 參數中指定的控制器值。

若要判斷函式失敗，或控制器將啟用旗標設定為0，請遵循下列步驟：

  1. 呼叫 SetLastError 函式，將最後一個錯誤設定為 ERROR_SUCCESS。
  2. 呼叫 GetTraceEnableFlags 函式以擷取啟用旗標。
  3. 如果啟用旗標值為 0，請呼叫 GetLastError 函式以擷取最後一個已知錯誤。
  4. 如果最後一個已知錯誤 ERROR_SUCCESS，控制器會將啟用旗標設定為 0;否則， GetTraceEnableFlags 函 式失敗，發生最後一個已知錯誤。

備註

提供者可以使用此值來控制其產生的事件。 例如，提供者可以將事件分組為事件的邏輯類別，並使用此值來啟用或停用其產生。

範例

如需使用 GetTraceEnableFlags 的範例，請參閱 使用MOF擷取事件數據。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 evntrace.h
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

GetTraceEnableLevel

GetTraceLoggerHandle