GetTraceLoggerHandle 関数 (evntrace.h)

RegisterTraceGuids ベース ("クラシック") イベントプロバイダーは、GetTraceLoggerHandle 関数を使用して、イベントを書き込むイベントトレースセッションのハンドルを取得します。

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

構文

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

[in] Buffer

WNODE_HEADER構造体へのポインター。 ETW は、この構造体を Buffer パラメーターのプロバイダーの ControlCallback 関数に渡します。

WNODE_HEADER の HistoricalContext メンバーには、セッションのハンドルが含まれています。

関数が成功すると、イベントトレースセッションハンドルが返されます。

関数が失敗した場合は、 INVALID_HANDLE_VALUEを返します。エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

GetTraceEnableFlags 関数と GetTraceEnableLevel 関数を呼び出すときは、ハンドルを使用して、EnableTrace 関数に渡される有効化フラグとレベル値を取得します。

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


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