SetupDiBuildClassInfoList 関数 (setupapi.h)

[アーティクル]
08/26/2023

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

こちらもご覧ください

SetupDiBuildClassInfoListEx

SetupDiGetClassDescription

SetupDiGetINFClass