SetupDiGetClassImageIndex-Funktion (setupapi.h)

  • Artikel

Die SetupDiGetClassImageIndex-Funktion ruft den Index innerhalb der Klassenbildliste einer angegebenen Klasse ab.

Syntax

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

Parameter

[in] ClassImageListData

Ein Zeiger auf eine SP_CLASSIMAGELIST_DATA-Struktur , die eine Klassenbildliste beschreibt, die das Image für die Geräteeinrichtungsklasse enthält, die durch den ClassGuid-Parameter angegeben wird.

[in] ClassGuid

Ein Zeiger auf die GUID der Gerätesetupklasse, für die der Index des Klassenimages in der angegebenen Klassenimageliste abgerufen werden soll.

[out] ImageIndex

Ein Zeiger auf eine INT-typisierte Variable, die den Index des angegebenen Klassenimages in der Klassenbildliste empfängt.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.

Hinweise

Wenn die angegebene Gerätesetupklasse nicht in der liste der angegebenen Klassenimages enthalten ist, gibt SetupDiGetClassImageIndex den Imageindex für die Setupklasse des Unbekannten Geräts im ImageIndex-Parameter zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile setupapi.h (einschließlich Setupapi.h)
Bibliothek Setupapi.lib
DLL Setupapi.dll

Weitere Informationen

SetupDiGetClassImageList

SetupDiGetClassImageListEx