SetupDiGetClassImageIndex 関数 (setupapi.h)

SetupDiGetClassImageIndex 関数は、指定したクラスのクラス イメージ リスト内のインデックスを取得します。

構文

WINSETUPAPI BOOL SetupDiGetClassImageIndex(
  [in]  PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in]  const GUID              *ClassGuid,
  [out] PINT                    ImageIndex
);

パラメーター

[in] ClassImageListData

ClassGuidパラメーターで指定されたデバイス セットアップ クラスのイメージを含むクラス イメージ リストを記述するSP_CLASSIMAGELIST_DATA構造体へのポインター。

[in] ClassGuid

指定したクラス イメージ リスト内のクラス イメージのインデックスを取得するデバイス セットアップ クラスの GUID へのポインター。

[out] ImageIndex

クラス イメージ リスト内の指定されたクラス イメージのインデックスを受け取る INT 型の変数へのポインター。

戻り値

成功した場合、関数は TRUE を 返します。 それ以外の場合は FALSE を 返し、ログに記録されたエラーは GetLastError の呼び出しによって取得できます。

注釈

指定したデバイス セットアップ クラスが指定したクラス イメージ リストに含まれていない場合、 SetupDiGetClassImageIndex は ImageIndex パラメーターの Unknown デバイス セットアップ クラスのイメージ インデックスを返します。

要件

要件 値
サポートされている最小のクライアント Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム デスクトップ
Header setupapi.h (Setupapi.h を含む)
Library Setupapi.lib
[DLL] Setupapi.dll

こちらもご覧ください

SetupDiGetClassImageList

SetupDiGetClassImageListEx