GetTraceEnableLevel 関数 (evntrace.h)

RegisterTraceGuids ベース ("Classic") イベントプロバイダーは、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 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	evntrace.h
Library	Advapi32.lib
[DLL]	Advapi32.dll