OpenTraceFromRealTimeLogger 関数 (evntrace.h)

アクティブなリアルタイム ETW セッションにアタッチされたトレース処理セッションを作成します。

構文

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

パラメーター

LoggerName

リアルタイム イベント トレース セッションの名前。ログ ファイルからデータを処理する場合は NULL 。 OpenTraceFromRealTimeLogger を呼び出してリアルタイム セッションのデータを使用する場合は、このメンバーの値を指定します。

OpenTraceFromRealTimeLogger を呼び出すときに、LogFileHeader が NULL 以外の場合、LoggerName は NULL である必要があります。

トレース コントローラーが EVENT_TRACE_REAL_TIME_MODE フラグを含むように EVENT_TRACE_PROPERTIES の LogFileMode メンバーを設定している場合にのみ、イベントをリアルタイムで使用できます。

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

Options

この処理セッションの構成オプション。 詳細については、「 ETW_OPEN_TRACE_OPTIONS 」を参照してください。

LogFileHeader

ログ ファイルのヘッダー情報。 詳細については、「 TRACE_LOGFILE_HEADER 」を参照してください。

戻り値

この処理セッションを識別するために使用される TRACEHANDLE。 通常は ProcessTrace に渡され、処理を開始し、 CloseTrace から最後の処理に渡されます。

注釈

返された TRACEHANDLE で ProcessTrace が呼び出されると、フラッシュされると ETW セッションからバッファーが受信され、すぐに処理が開始され、Options で指定されたコールバックが呼び出されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	evntrace.h
Library	Windows 8.1および Windows Server 2012 R2 の Sechost.lib。Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista、Windows XP 上の Advapi32.lib
[DLL]	Windows 8.1 および Windows Server 2012 R2 の Sechost.dll;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista、Windows XP での Advapi32.dll