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 を返します。 それ以外の場合、この関数は、他のリターン コードに加えて、次のいずれかのリターン コードを返します。
| リターン コード | 説明 |
|---|---|
|
マニフェストにプロバイダー GUID に対して定義されたイベントはありません。 |
|
プロバイダーのメタデータが見つかりませんでした。 |
|
Buffer パラメーターが指すバッファーのサイズが小さすぎます。 BufferSize パラメーターに設定されている必要なバッファー サイズを使用して、新しいバッファーを割り当てます。 |
|
1 つ以上のパラメーターが無効です。 |
|
指定されたプロバイダー GUID のスキーマ情報が見つかりませんでした。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | tdh.h |
| Library | Tdh.lib |
| [DLL] | Tdh.dll |