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 を使用します。

要件

こちらもご覧ください

SetupDiBuildClassInfoListEx

SetupDiGetClassDescription

SetupDiGetINFClass