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 |