SetupDiBuildClassInfoList, fonction (setupapi.h)

  • Article

La fonction SetupDiBuildClassInfoList retourne une liste de GUID de classe d’installation qui identifient les classes installées sur un ordinateur local.

Syntaxe

WINSETUPAPI BOOL SetupDiBuildClassInfoList(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize
);

Paramètres

[in] Flags

Indicateurs utilisés pour contrôler l’exclusion des classes de la liste. Si aucun indicateur n’est spécifié, toutes les classes d’installation sont incluses dans la liste. Il peut s’agir d’une combinaison des valeurs suivantes :

DIBCI_NOINSTALLCLASS

Excluez une classe si elle a l’entrée de valeur NoInstallClass dans sa clé de Registre.

DIBCI_NODISPLAYCLASS

Excluez une classe si elle a l’entrée de valeur NoDisplayClass dans sa clé de Registre.

[out, optional] ClassGuidList

Pointeur vers un tableau de type GUID qui reçoit une liste de GUID de classe d’installation. Ce pointeur est facultatif et peut être NULL.

[in] ClassGuidListSize

Nombre de GUID dans le tableau vers lequel pointe le paramètre ClassGuildList . Si ClassGuidList a la valeur NULL, ClassGuidSize doit être égal à zéro.

[out] RequiredSize

Pointeur vers une variable de type DWORD qui reçoit le nombre de GUID retournés (si le nombre est inférieur ou égal à la taille, en GUID, du tableau vers lequel pointe le paramètre ClassGuidList ).

Si ce nombre est supérieur à la taille du tableau ClassGuidList , il indique la taille du tableau ClassGuidList pour contenir tous les GUID de classe.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, elle retourne FALSE et l’erreur journalisée peut être récupérée en effectuant un appel à GetLastError.

Remarques

Pour récupérer le nombre de classes installées sur un ordinateur local, appelez SetupDiBuildClassInfoList avec ClassGuidList défini sur NULL et ClassGuidSize défini sur zéro. En réponse à un tel appel, la fonction retourne le nombre de classes dans *RequiredSize.

SetupDiBuildClassInfoList ne retourne pas de GUID de classe pour une classe si l’entrée de valeur NoUseClass existe dans la clé de Registre de la classe.

Pour récupérer la liste des GUID de classe d’installation installés sur un système distant, utilisez SetupDiBuildClassInfoListEx.

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

Voir aussi

SetupDiBuildClassInfoListEx

SetupDiGetClassDescription

SetupDiGetINFClass