GetTraceEnableLevel 函式 (evntrace.h)

  • 發行項

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

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

語法

UCHAR WMIAPI GetTraceEnableLevel(
  [in] TRACEHANDLE TraceHandle
);

參數

[in] TraceHandle

呼叫 GetTraceLoggerHandle 函式取得的事件追蹤會話控制碼。

傳回值

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

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

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

備註

提供者會使用此值來控制其產生的事件嚴重性。 例如，提供者可以使用此值來判斷它是否應該產生參考性、警告或錯誤事件。

範例

如需使用 GetTraceEnableLevel的範例，請參閱 使用 MOF 擷取事件資料。

需求

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

另請參閱

GetTraceEnableFlags

GetTraceLoggerHandle