EnumerateTraceGuids

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

EnumerateTraceGuids GuidPropertiesArray, PropertyArrayCount, GuidCount

GuidPropertiesArray : [var] [TRACE_GUID_PROPERTIES](/windows/win32/api/evntrace/ns-evntrace-trace_guid_properties) 構造体へのポインタの配列。配列内の各ポインタは、**TRACE_GUID_PROPERTIES** 構造体を格納するのに十分な領域を持つバッファを指す必要がある。
PropertyArrayCount : [int] _GuidPropertiesArray_ 配列内のポインタの数。
GuidCount : [var] コンピュータに登録されているイベントトレーシングプロバイダの実際の数を受け取る。

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

解説

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

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。失敗した場合、戻り値は [system error
codes](/windows/win32/debug/system-error-codes)
のいずれかとなる。一般的なエラーとその原因を以下に示す。- **ERROR_INVALID_PARAMETER**
次のいずれかが真である。- _PropertyArrayCount_ がゼロ- _GuidPropertiesArray_ が
**NULL** である。- **ERROR_MORE_DATA**
プロパティ配列が、登録済みのすべてのプロバイダの情報を受け取るには小さすぎる (_GuidCount_ が
_PropertyArrayCount_ より大きい)。関数は _PropertyArrayCount_ で指定された数の構造体で
_GuidPropertiesArray_ を埋める。

[備考]
この関数は、開始されたがまだ停止されていないイベント トレース プロバイダ
([RegisterTraceGuids](/windows/win32/api/evntrace/nf-evntrace-registertraceguidsa)
や
[EventRegister](/windows/win32/api/evntprov/nf-evntprov-eventregister)
で開始されたもの) に関する情報を返す。> [!Note] > システムに登録されているプロバイダ マニフェスト (たとえば
`wevtutil` で登録されたマニフェスト)
に関する情報を取得するには、[TdhEnumerateProviders](/windows/win32/api/tdh/nf-tdh-tdhenumerateproviders)
を使用する。**TRACE_GUID_PROPERTIES.IsEnable** が **TRUE**
の場合、[TRACE_GUID_PROPERTIES](ns-evntrace-trace_guid_properties.md) の
LoggerId メンバを使用して、そのプロバイダを最も最近に有効化したセッションを特定できる。この一覧に
SystemTraceProvider のプロバイダは含まれない。

情報