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 |