OpenTraceA 関数 (evntrace.h)

OpenTrace 関数は、ETW リアルタイム トレース セッションまたは ETW ログ ファイルからイベントを使用するための ETW トレース処理ハンドルを開きます。

構文

PROCESSTRACE_HANDLE WMIAPI OpenTraceA(
  [in, out] PEVENT_TRACE_LOGFILEA Logfile
);

パラメーター

[in, out] Logfile

EVENT_TRACE_LOGFILE構造体へのポインター。 構造体は、(ETW ログ ファイルまたはリアルタイム ETW セッションから) イベントを使用するソースを指定し、コンシューマーがイベントの受信に使用するコールバックを指定します。 成功すると、 OpenTrace は、開かれたファイルまたはセッションからの情報を使用して構造体を更新します。

戻り値

関数が成功すると、トレース処理ハンドルが返されます。 ハンドルは CloseTrace を使用して閉じる必要があります。

関数が失敗した場合は、 INVALID_PROCESSTRACE_HANDLEを返します。 (INVALID_PROCESSTRACE_HANDLE は と (UINT64)UINTPTR_MAX同じです)。

関数が失敗した場合は、 GetLastError 関数を使用して拡張エラー情報を取得できます。 一般的なエラーとその原因を次に示します。

• ERROR_INVALID_PARAMETER

  Logfile パラメーターは NULL です。

• ERROR_BAD_PATHNAME

  EVENT_TRACE_LOGFILE の LoggerName メンバーを指定しなかった場合は、有効なログ ファイル名を指定する必要があります。

• ERROR_ACCESS_DENIED

  管理者特権を持つユーザー、パフォーマンス ログ ユーザー グループ内のユーザー、LocalSystem、LocalService、NetworkService として実行されているサービスのみが、リアルタイムでイベントを使用できます。 制限付きユーザーにリアルタイムでイベントを使用する機能を付与するには、それらを [パフォーマンス ログ ユーザー] グループに追加します。

  Windows XP と Windows 2000: 誰でもリアルタイム イベントを使用できます。

注釈

トレース コンシューマーはこの関数を呼び出して、トレース処理セッションを開きます。

OpenTrace を呼び出した後、ProcessTrace 関数を呼び出してイベントを処理します。 イベントの処理が完了したら、 CloseTrace 関数を呼び出してトレース処理ハンドルを閉じます。

例

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

要件

こちらもご覧ください

CloseTrace

EVENT_TRACE_LOGFILE

ProcessTrace