SetupDiGetClassBitmapIndex, fonction (setupapi.h)
La fonction SetupDiGetClassBitmapIndex récupère l’index de la mini-icône fournie pour la classe spécifiée.
Syntaxe
WINSETUPAPI BOOL SetupDiGetClassBitmapIndex(
[in, optional] const GUID *ClassGuid,
[out] PINT MiniIconIndex
);
Paramètres
[in, optional] ClassGuid
Pointeur vers le GUID de la classe d’installation de l’appareil pour laquelle récupérer la mini-icône. Ce pointeur est facultatif et peut avoir la valeur NULL.
[out] MiniIconIndex
Pointeur vers une variable de type INT qui reçoit l’index de la mini-icône pour la classe d’installation de l’appareil spécifiée. Si le paramètre ClassGuid a la valeur NULL ou s’il n’existe pas de mini-icône pour la classe spécifiée, SetupDiGetClassBitmapIndex retourne l’index de la mini-icône pour la classe d’installation d’appareil inconnu.
Valeur retournée
S’il existe une icône minimale pour la classe d’installation de l’appareil spécifiée, SetupDiGetClassBitmapIndex retourne TRUE. Sinon, cette fonction retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError. Si le paramètre ClassGuid a la valeur NULL ou s’il n’y a pas de mini-icône pour la classe spécifiée, la fonction retourne FALSE et GetLastError retourne ERROR_NO_DEVICE_ICON.
Remarques
Pour obtenir la liste des mini-icônes de la classe d’installation de l’appareil et de leurs index correspondants, consultez SetupDiDrawMiniIcon.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |