SetupDiGetClassImageIndex-Funktion (setupapi.h)
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 |