CM_Enumerate_Classes, fonction (cfgmgr32.h)
La fonction CM_Enumerate_Classes , lorsqu’elle est appelée à plusieurs reprises, énumère les classes d’appareils installées de l’ordinateur local en fournissant le GUID de chaque classe.
Syntaxe
CMAPI CONFIGRET CM_Enumerate_Classes(
[in] ULONG ulClassIndex,
[out] LPGUID ClassGuid,
[in] ULONG ulFlags
);
Paramètres
[in] ulClassIndex
Index fourni par l’appelant dans la liste des classes d’appareils de l’ordinateur. Pour plus d’informations, consultez la section Remarques.
[out] ClassGuid
Adresse fournie par l’appelant d’une structure GUID (décrite dans le Microsoft Windows SDK) pour recevoir le GUID d’une classe d’appareil.
[in] ulFlags
À compter de Windows 8, les appelants peuvent spécifier les indicateurs suivants :
CM_ENUMERATE_CLASSES_INSTALLER
Énumérer les classes de configuration d’appareil.
CM_ENUMERATE_CLASSES_INTERFACE
Énumérer les classes d’interface d’appareil.
Sinon, doit être défini sur zéro.
Valeur retournée
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.
Remarques
Pour énumérer les classes d’appareils de l’ordinateur local, appelez CM_Enumerate_Classes à plusieurs reprises, en commençant par une valeur ulClassIndex de zéro et en incrémentant la valeur d’index à chaque appel suivant jusqu’à ce que la fonction retourne CR_NO_SUCH_VALUE. Certaines valeurs d’index peuvent représenter des entrées de liste contenant des données de classe non valides, auquel cas la fonction retourne CR_INVALID_DATA. Cette valeur de retour peut être ignorée.
Les GUID de classe obtenus à partir de cette fonction peuvent être utilisés comme entrée dans les fonctions d’installation de l’appareil.
À compter des systèmes d’exploitation Windows 8 et ultérieurs, les appelants peuvent utiliser le membre ulFlags pour spécifier les classes d’appareils que CM_Enumerate_Classes doivent retourner. Avant Windows 8, CM_Enumerate_Classes renvoyait uniquement les classes de configuration d’appareil.
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 | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |