GetTraceEnableLevel 函式 (evntrace.h)
RegisterTraceGuids型 (「傳統」) 事件提供者會使用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 擷取事件資料。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | evntrace.h |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |