SetTraceCallback 関数 (evntrace.h)

SetTraceCallback 関数は、指定されたイベント トレース クラスのイベントを処理する EventCallback 関数を指定します。

構文

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

パラメーター

[in] pGuid

イベントを受信するイベント トレース クラスのクラス GUID へのポインター。 カーネル プロバイダー クラス GUID の一覧については、「 NT カーネル ロガー定数」を参照してください。

[in] EventCallback

イベント トレース クラスに属するイベントを処理するために使用される EventCallback 関数へのポインター。

戻り値

関数が成功した場合、戻り値はERROR_SUCCESS。

関数が失敗した場合、戻り値は システム エラー コードの 1 つです。 一般的なエラーとその原因を次に示します。

• ERROR_INVALID_PARAMETER

  次のいずれかの条件に該当する:

  • pGuid が NULL です。
  • EventCallback が NULL です。

注釈

コンシューマーはこの関数を呼び出します。

イベント トレース クラスに指定できるコールバック関数は 1 つだけです。 イベント トレース クラスに複数のコールバック関数を指定した場合、最後のコールバック関数はそのイベント トレース クラスのイベントを受け取ります。

コールバック関数がイベント トレース クラスのイベントを受信しないようにするには、 RemoveTraceCallback 関数を呼び出します。 トレースを閉じると、コールバックはコールバックの受信を自動的に停止します。

この関数を使用すると、 TraceEvent 関数のいずれかを使用して書き込まれたイベントを受信できます。 この関数を使用して、 EventWrite 関数の 1 つを使用してイベントをログに記録したプロバイダーからのイベントを使用することはできません。

Requirements

こちらも参照ください

EventCallback

ProcessTrace

RemoveTraceCallback