Partager via

CM_Enumerate_Classes, fonction (cfgmgr32.h)

  • Article

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

Voir aussi

CM_Enumerate_Classes_Ex