SetupDiBuildClassInfoList 関数 (setupapi.h)
SetupDiBuildClassInfoList 関数は、ローカル コンピューターにインストールされているクラスを識別するセットアップ クラス GUID の一覧を返します。
構文
WINSETUPAPI BOOL SetupDiBuildClassInfoList(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
パラメーター
[in] Flags
リストからのクラスの除外を制御するために使用されるフラグ。 フラグが指定されていない場合は、すべてのセットアップ クラスが一覧に含まれます。 次の値の組み合わせを指定できます。
DIBCI_NOINSTALLCLASS
レジストリ キーに NoInstallClass 値エントリがある場合は、クラスを除外します。
DIBCI_NODISPLAYCLASS
レジストリ キーに NoDisplayClass 値エントリがある場合は、クラスを除外します。
[out, optional] ClassGuidList
セットアップ クラス GUID の一覧を受け取る GUID 型の配列へのポインター。 このポインターは省略可能であり、 NULL にすることができます。
[in] ClassGuidListSize
ClassGuildList パラメーターによって指される配列内の GUID の数。 ClassGuidList が NULL の場合、ClassGuidSize は 0 である必要があります。
[out] RequiredSize
返される GUID の数を受け取る DWORD 型の変数へのポインター ( 数値が ClassGuidList パラメーターによって指される配列のサイズ (GUID) 以下の場合)。
この数値が ClassGuidList 配列のサイズより大きい場合、すべてのクラス GUID を含めるために ClassGuidList 配列のサイズを示します。
戻り値
成功した場合、関数は TRUE を 返します。 それ以外の場合は FALSE を 返し、 GetLastError を呼び出すことでログに記録されたエラーを取得できます。
注釈
ローカル コンピューターにインストールされているクラスの数を取得するには、ClassGuidList が NULL に設定され、ClassGuidSize が 0 に設定された SetupDiBuildClassInfoList を呼び出します。 このような呼び出しに応答して、 関数は RequiredSize 内のクラスの数を*返します。
NoUseClass 値エントリがクラスのレジストリ キーに存在する場合、SetupDiBuildClassInfoList はクラスのクラス GUID を返しません。
リモート システムにインストールされているセットアップ クラス GUID の一覧を取得するには、 SetupDiBuildClassInfoListEx を使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | setupapi.h (Setupapi.h を含む) |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |