SetTraceCallback 関数 (evntrace.h)
重要
この関数は使用しないでください。以降のバージョンでは使用できない場合があります。 代わりに、 EventRecordCallback 関数でイベント トレース クラスをフィルター処理します。
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 関数のいずれかを使用してイベントをログに記録したプロバイダーのイベントを使用することはできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | 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 |