GetTraceEnableFlags 函式 (evntrace.h)
RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 GetTraceEnableFlags 函式來擷取追蹤控制器所指定的啟用旗標，以指出要追蹤的事件類別。
提供者會從其 ControlCallback 函式呼叫此函式。
語法
ULONG WMIAPI GetTraceEnableFlags(
[in] TRACELOGGER_HANDLE TraceHandle
);
參數
[in] TraceHandle
呼叫 GetTraceLoggerHandle 函式取得的事件追蹤會話句柄。
傳回值
傳回呼叫 EnableTrace 函式時，EnableFlag 參數中指定的控制器值。
若要判斷函式失敗，或控制器將啟用旗標設定為0，請遵循下列步驟：
- 呼叫 SetLastError 函式，將最後一個錯誤設定為 ERROR_SUCCESS。
- 呼叫 GetTraceEnableFlags 函式以擷取啟用旗標。
- 如果啟用旗標值為 0，請呼叫 GetLastError 函式以擷取最後一個已知錯誤。
- 如果最後一個已知錯誤 ERROR_SUCCESS，控制器會將啟用旗標設定為 0;否則， GetTraceEnableFlags 函 式失敗，發生最後一個已知錯誤。
備註
提供者可以使用此值來控制其產生的事件。 例如，提供者可以將事件分組為事件的邏輯類別，並使用此值來啟用或停用其產生。
範例
如需使用 GetTraceEnableFlags 的範例，請參閱 使用MOF擷取事件數據。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | evntrace.h |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |