次の方法で共有

TraceLoggingSetInformation 関数 (traceloggingprovider.h)

  • [アーティクル]

EventSetInformation を呼び出してトレース ログ プロバイダーを構成します。

構文

TLG_STATUS TraceLoggingSetInformation(
  TraceLoggingHProvider hProvider,
  EVENT_INFO_CLASS      informationClass,
  PVOID                 pvInformation,
  ULONG                 cbInformation
);

パラメーター

hProvider

構成するトレース ログ プロバイダーを処理します。 プロバイダーは 登録済みの 状態である必要があります。

informationClass

構成する設定の EVENT_INFO_CLASS 。

pvInformation

構成する設定の値を含む入力バッファー。 このバッファーの形式は 、informationClass パラメーターの値によって異なります。

cbInformation

入力バッファー内のデータのサイズ (バイト単位)。

戻り値

ユーザー モード コードからこの関数を呼び出すと、関数は を HRESULT返します。 マクロを SUCCEEDED() 使用して、関数が成功したかどうかを判断します。

カーネル モード コードからこの関数を呼び出すと、関数は を NTSTATUS返します。 マクロを NT_SUCCESS() 使用して、関数が成功したかどうかを判断します。

注釈

この関数は、 EventSetInformation 関数のラッパーとして機能します。

EventSetInformation 関数は、Windows のすべてのバージョンで使用できるわけではありません。 TraceLoggingSetInformation の既定の動作は、(ユーザー モード) または NTDDI_VERSION (カーネル モード) マクロのコンパイル時のWINVER値によって異なります。

  • (または NTDDI_VERSIONでWINVER指定されている) Windows のターゲット バージョンが EventSetInformation をサポートしていることがわかっている場合、TraceLoggingSetInformation は EventSetInformation を直接呼び出します。
  • それ以外の場合、TraceLoggingSetInformation は、EventSetInformation を検索して呼び出すために、GetProcAddress (ユーザー モード) または MmGetSystemRoutineAddress (カーネル モード) を使用します。 これが失敗した場合、TraceLoggingSetInformation は (ユーザー モード) または STATUS_NOT_SUPPORTED (カーネル モード) を返HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)します。

この関数の既定の動作をオーバーライドするには、 の前にマクロを TLG_HAVE_EVENT_SET_INFORMATION 定義します #include <TraceLoggingProvider.h>。

  • #define TLG_HAVE_EVENT_SET_INFORMATION 0その後、TraceLoggingSetInformation では何も行われ、(ユーザー モード) または STATUS_ENTRYPOINT_NOT_FOUND (カーネル モード) が返HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)されます。
  • #define TLG_HAVE_EVENT_SET_INFORMATION 1その後、TraceLoggingSetInformation によって EventSetInformation が直接呼び出されます。
  • #define TLG_HAVE_EVENT_SET_INFORMATION 2その後、TraceLoggingSetInformation は、GetProcAddress (ユーザー モード) または MmGetSystemRoutineAddress (カーネル モード) を使用して EventSetInformation を呼び出します。

詳細については、ヘッダーのマクロに TraceLoggingProvider.h 関するコメントを TLG_HAVE_EVENT_SET_INFORMATION 参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
Header traceloggingprovider.h
Library Advapi32.lib

こちらもご覧ください

TraceLoggingRegister

EventSetInformation

EVENT_INFO_CLASS