TdhEnumerateProviderFilters 関数 (tdh.h)
TdhEnumerateProviderFilters 関数は、指定されたプロバイダーがマニフェストで定義したフィルターを列挙します。
構文
TDHSTATUS TdhEnumerateProviderFilters(
[in] LPGUID Guid,
[in] ULONG TdhContextCount,
[in, optional] PTDH_CONTEXT TdhContext,
[in] ULONG *FilterCount,
[out, optional] PPROVIDER_FILTER_INFO *Buffer,
[in, out] ULONG *BufferSize
);
パラメーター
[in] Guid
フィルターを取得するプロバイダーを識別する GUID。
[in] TdhContextCount
使用しません。
[in, optional] TdhContext
使用しません。
[in] FilterCount
pBuffer バッファーに含まれるフィルター構造の数。 pBuffer バッファーが不十分な場合は 0 です。
[out, optional] Buffer
フィルター情報を受け取るユーザー割り当てバッファー。 詳細については、PROVIDER_FILTER_INFO構造に 関するページを 参照してください。
[in, out] BufferSize
pBuffer バッファーのサイズ (バイト単位)。 関数が成功した場合、このパラメーターは使用されるバッファーのサイズを受け取ります。 バッファーが小さすぎる場合、関数は ERROR_INSUFFICIENT_BUFFERを返し、このパラメーターを必要なバッファー サイズに設定します。 入力時にバッファー サイズが 0 の場合、バッファーにデータは返されません。このパラメーターは必要なバッファー サイズを受け取ります。
戻り値
成功した場合は、ERROR_SUCCESSを返します。 それ以外の場合、この関数は、他の戻りコードに加えて、次のいずれかのリターン コードを返します。
リターン コード | 説明 |
---|---|
|
pBuffer バッファーのサイズが小さすぎます。 新しいバッファーを割り当てるには、 pBufferSize で必要なバッファー サイズ セットを使用します。 |
|
イベントのスキーマが見つかりませんでした。 |
|
1 つ以上のパラメーターが無効です。 |
|
マニフェストの resourceFileName 属性には、プロバイダー バイナリの場所が含まれています。 マニフェストを登録すると、場所がレジストリに書き込まれます。 TDH は、登録された場所に基づいてバイナリを見つけることができませんでした。 |
注釈
この関数は、XML マニフェストを使用して情報を取得します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | tdh.h |
Library | Tdh.lib |
[DLL] | Tdh.dll |