SetupDiGetClassImageListExA 関数 (setupapi.h)

SetupDiGetClassImageListEx 関数は、ローカル またはリモート システムにインストールされているすべてのクラスのビットマップのイメージ リストを作成します。

構文

WINSETUPAPI BOOL SetupDiGetClassImageListExA(
  [out]          PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in, optional] PCSTR                   MachineName,
                 PVOID                   Reserved
);

パラメーター

[out] ClassImageListData

イメージ リストへのハンドルを含む、クラスイメージリストに関する情報を受け取る SP_CLASSIMAGELIST_DATA 構造体へのポインター。 この構造体の cbSize フィールドは、この関数を呼び出す前に、構造体のサイズ (バイト単位) で初期化する必要があります。または失敗します。

[in, optional] MachineName

SetupDiGetClassImageListEx クラスがビットマップ ビルドする必要があるリモート システムの名前を提供する NULL で終わる文字列へのポインター。 このパラメーターは省略可能であり、NULLできます。 MachineName が NULL場合は、SetupDiGetClassImageListEx ローカル システムのリストをビルドします。

注意

この機能は削除されたため、この機能を使用してリモート コンピューターにアクセスすることは、Windows 8 および Windows Server 2012 以降ではサポートされていません。

Reserved

NULLする必要があります。

戻り値

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

備考

この関数によってビルドされたイメージ リストは、SetupDiDestroyClassImageList呼び出すことによって破棄する必要があります。

注 リモート コンピューター上のクラス固有のアイコンは、クラスがローカル コンピューターにも存在する場合にのみ表示できます。 したがって、リモート コンピューターに Xクラスがあるが、クラス X がローカルにインストールされていない場合は、汎用 (不明) アイコンが返されます。

 

手記

setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupDiGetClassImageListEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の	デスクトップ
ヘッダー	setupapi.h (Setupapi.h を含む)
ライブラリ	Setupapi.lib

関連項目

SetupDiDestroyClassImageList の

SetupDiGetClassImageList の