CM_Enumerate_Classes_Ex, fonction (cfgmgr32.h)
[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Enumerate_Classes à la place.]
La fonction CM_Enumerate_Classes_Ex , lorsqu’elle est appelée à plusieurs reprises, énumère les classes d’appareils installées d’un ordinateur local ou distant, en fournissant le GUID de chaque classe.
Syntaxe
CMAPI CONFIGRET CM_Enumerate_Classes_Ex(
[in] ULONG ulClassIndex,
[out] LPGUID ClassGuid,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
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 Notes suivante.
[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.
[in, optional] hMachine
Handle de machine fourni par l’appelant, obtenu à partir d’un appel précédent à CM_Connect_Machine.
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 d’un ordinateur local ou distant, appelez CM_Enumerate_Classes_Ex plusieurs fois, en commençant par une valeur d’index ulClassIndex égale à 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_Ex doivent retourner. Avant Windows 8, CM_Enumerate_Classes_Ex renvoyait uniquement les classes de configuration d’appareil.
La fonctionnalité permettant d’accéder aux ordinateurs distants a été supprimée dans Windows 8 et Windows Server 2012 systèmes d’exploitation et versions ultérieures. Vous ne pouvez donc pas accéder aux ordinateurs distants lors de l’exécution sur ces versions de Windows.
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour