TdhGetManifestEventInformation 関数 (tdh.h)

  • [アーティクル]

TdhGetManifestEventInformation 関数は、マニフェスト内のイベントに関するメタデータを取得します。

構文

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

パラメーター

[in] ProviderGuid

イベント メタデータを取得するマニフェスト プロバイダーを識別する GUID。

[in] EventDescriptor

イベント ID、バージョン、操作コード、キーワード (keyword)などの情報を含むイベント記述子へのポインター。 詳細については、EVENT_DESCRIPTOR構造に 関 するページを参照してください。

[out] Buffer

プロバイダー マニフェスト内のイベントに関するメタデータを受け取るユーザー割り当てバッファー。 詳細については、TRACE_EVENT_INFO構造に 関するページを 参照してください。

[in, out] BufferSize

Buffer パラメーターが指すバッファーのサイズ (バイト単位)。 関数が成功した場合、このパラメーターは使用されるバッファーのサイズを受け取ります。 バッファーが小さすぎる場合、関数は ERROR_INSUFFICIENT_BUFFER を返し、このパラメーターを必要なバッファー サイズに設定します。 入力時にバッファー サイズが 0 の場合、バッファーにデータは返されません。このパラメーターは必要なバッファー サイズを受け取ります。

戻り値

成功した場合 はERROR_SUCCESS を返します。 それ以外の場合、この関数は、他のリターン コードに加えて、次のいずれかのリターン コードを返します。

リターン コード 説明
ERROR_EMPTY
 マニフェストにプロバイダー GUID に対して定義されたイベントはありません。
ERROR_FILE_NOT_FOUND
 プロバイダーのメタデータが見つかりませんでした。
ERROR_INSUFFICIENT_BUFFER
 Buffer パラメーターが指すバッファーのサイズが小さすぎます。 BufferSize パラメーターに設定されている必要なバッファー サイズを使用して、新しいバッファーを割り当てます。
ERROR_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。
ERROR_NOT_FOUND
 指定されたプロバイダー GUID のスキーマ情報が見つかりませんでした。

要件

要件 値
サポートされている最小のクライアント Windows 8.1 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー tdh.h
Library Tdh.lib
[DLL] Tdh.dll

こちらもご覧ください

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents