GetTraceEnableFlags 関数 (evntrace.h)

RegisterTraceGuids ベース ("クラシック") イベントプロバイダーは、GetTraceEnableFlags 関数を使用して、トレースするイベントのカテゴリを示すためにトレースコントローラーによって指定された有効フラグを取得します。

プロバイダーは、 ControlCallback 関数からこの関数を呼び出します。

構文

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACEHANDLE TraceHandle
);

[in] TraceHandle

GetTraceLoggerHandle 関数を呼び出して取得したイベントトレースセッションを処理します。

EnableTrace 関数を呼び出すときに EnableFlag パラメーターで指定されたコントローラーの値を返します。

関数が失敗したか、コントローラーが有効化フラグを 0 に設定したかを確認するには、次の手順に従います。

SetLastError 関数を呼び出して、最後のエラーをERROR_SUCCESSに設定します。
GetTraceEnableFlags 関数を呼び出して、有効フラグを取得します。
enable flags 値が 0 の場合は、 GetLastError 関数を呼び出して、最後の既知のエラーを取得します。
最後の既知のエラーが ERROR_SUCCESS場合、コントローラーは有効化フラグを 0 に設定します。それ以外の場合、 GetTraceEnableFlags 関数は 最後の既知のエラーで失敗しました。

プロバイダーはこの値を使用して、生成するイベントを制御できます。たとえば、プロバイダーはイベントをイベントの論理カテゴリにグループ化し、この値を使用して生成を有効または無効にすることができます。

GetTraceEnableFlags を使用する例については、「MOF を使用したイベントデータの取得」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	evntrace.h
Library	Advapi32.lib
[DLL]	Advapi32.dll