TdhEnumerateProviders 関数 (tdh.h)
コンピューターに登録されているすべてのプロバイダーの一覧を取得します。
構文
TDHSTATUS TdhEnumerateProviders(
[out] PPROVIDER_ENUMERATION_INFO pBuffer,
[in, out] ULONG *pBufferSize
);
パラメーター
[out] pBuffer
コンピューター上のイベントをパブリックに定義するプロバイダーの配列。 詳細については、PROVIDER_ENUMERATION_INFO構造に 関するページを 参照してください。
[in, out] pBufferSize
pBuffer バッファーのサイズ (バイト単位)。 関数が成功した場合、このパラメーターは使用されるバッファーのサイズを受け取ります。 バッファーが小さすぎる場合、関数は ERROR_INSUFFICIENT_BUFFERを返し、このパラメーターを必要なバッファー サイズに設定します。 入力時にバッファー サイズが 0 の場合、バッファーにデータは返されません。このパラメーターは必要なバッファー サイズを受け取ります。
戻り値
成功した場合は、ERROR_SUCCESSを返します。 それ以外の場合、この関数は、他の戻りコードに加えて、次のいずれかのリターン コードを返します。
| リターン コード | 説明 |
|---|---|
| ERROR_INSUFFICIENT_BUFFER | pBuffer バッファーのサイズが小さすぎます。 新しいバッファーを割り当てるには、 pBufferSize で必要なバッファー サイズ セットを使用します。 |
| ERROR_INVALID_PARAMETER | 1 つ以上のパラメーターが無効です。 |
解説
TdhEnumerateProvidersForDecodingSource 関数を呼び出して、MOF クラスまたはマニフェスト ファイルをコンピューターに登録したプロバイダーの一覧を取得します。
登録されたイベント プロバイダーの数は、この関数の呼び出しの間で変動する可能性があるため、戻り値がERROR_INSUFFICIENT_BUFFERしなくなるまでループするループにこの関数を配置する必要があります。
例
プロバイダーを列挙する方法を示す例については、「プロバイダーの 列挙」を参照してください。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | tdh.h |
| Library | Tdh.lib |
| [DLL] | Tdh.dll |