共用方式為


GetTraceEnableFlags 函式 (evntrace.h)

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

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

語法

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACELOGGER_HANDLE 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