EnumerateTraceGuidsEx

現在コンピュータで動作しているイベント トレース プロバイダに関する情報を取得する。

EnumerateTraceGuidsEx TraceQueryInfoClass, InBuffer, InBufferSize, OutBuffer, OutBufferSize, ReturnLength

TraceQueryInfoClass : [int] 返す情報の種類を決定する。指定可能な値については [TRACE_QUERY_INFO_CLASS](/windows/win32/api/evntrace/ne-evntrace-trace_query_info_class) 列挙を参照。
InBuffer : [intptr] 情報を取得するプロバイダまたはプロバイダ グループの GUID。_TraceQueryInfoClass_ が **TraceGuidQueryInfo** または **TraceGroupQueryInfo** の場合にのみ GUID を指定する。
InBufferSize : [int] _InBuffer_ データのサイズ (バイト単位)。
OutBuffer : [intptr] 列挙された情報を含む、アプリケーションが割り当てたバッファ。情報の形式は _TraceQueryInfoClass_ の値によって異なる。
OutBufferSize : [int] _OutBuffer_ バッファのサイズ (バイト単位)。関数が成功した場合、_ReturnLength_ パラメータには使用されたバッファのサイズが格納される。バッファが小さすぎる場合、関数は `ERROR_INSUFFICIENT_BUFFER` を返し、_ReturnLength_ パラメータには必要なバッファサイズが格納される。入力時にバッファサイズがゼロの場合、バッファにデータは返されず、_ReturnLength_ パラメータには必要なバッファサイズが格納される。
ReturnLength : [var] _OutBuffer_ 内のデータの実際のサイズ (バイト単位)。

(プラグイン / モジュール : advapi32.dll)

解説

現在コンピュータで動作しているイベント トレース プロバイダに関する情報を取得する。

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。失敗した場合、戻り値は [system error
codes](/windows/win32/debug/system-error-codes)
のいずれかとなる。一般的なエラーとその原因を以下に示す。- **ERROR_INVALID_PARAMETER**
パラメータのいずれかが有効でない。- **ERROR_INSUFFICIENT_BUFFER** _OutBuffer_
バッファが、登録済みのすべてのプロバイダの情報を受け取るには小さすぎる。_ReturnLength_
で返されたサイズを使用してバッファを再確保する。

[備考]
この関数は、開始されたがまだ停止されていないイベント トレース プロバイダ
([RegisterTraceGuids](/windows/win32/api/evntrace/nf-evntrace-registertraceguidsa)
や
[EventRegister](/windows/win32/api/evntprov/nf-evntprov-eventregister)
で開始されたもの) に関する情報を返す。> [!Note] > システムに登録されているプロバイダ
マニフェストに関する情報を取得するには、[TdhEnumerateProviders](/windows/win32/api/tdh/nf-tdh-tdhenumerateproviders)
を使用する。_TraceQueryInfoClass_ が **TraceGuidQueryInfo** の場合、ETW
は情報のヘッダーとなる
[TRACE_GUID_INFO](/windows/win32/api/evntrace/ns-evntrace-trace_guid_info)
ブロックでデータを返す。情報ブロックには、同じ GUID を使用する各プロバイダの
[TRACE_PROVIDER_INSTANCE_INFO](/windows/win32/api/evntrace/ns-evntrace-trace_provider_instance_info)
ブロックが含まれる。各インスタンス情報ブロックには、プロバイダを有効化した各セッションの
[TRACE_ENABLE_INFO](/windows/win32/api/evntrace/ns-evntrace-trace_enable_info)
構造体が含まれる。

情報