Fonction SetupDiBuildClassInfoListExA (setupapi.h)
La fonction SetupDiBuildClassInfoListEx retourne une liste de GUID de classe d’installation qui inclut chaque classe installée sur le système local ou un système distant.
Syntaxe
WINSETUPAPI BOOL SetupDiBuildClassInfoListExA(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
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 une mémoire tampon qui reçoit une liste de GUID de classe d’installation.
[in] ClassGuidListSize
Fournit le nombre de GUID dans le tableau ClassGuildList .
[out] RequiredSize
Pointeur vers une variable qui reçoit le nombre de GUID retournés. Si ce nombre est supérieur à la taille du ClassGuidList, le nombre indique la taille du tableau ClassGuidList pour contenir la liste.
[in, optional] MachineName
Pointeur vers une chaîne terminée par NULL qui contient le nom d’un ordinateur distant à partir duquel récupérer les classes d’installation installées. Ce paramètre est facultatif et peut être NULL. Si MachineName a la valeur NULL, cette fonction génère une liste de classes installées sur l’ordinateur local.
Attention
L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.
Reserved
Doit avoir la valeur NULL.
Valeur retournée
La fonction retourne TRUE si elle réussit. Sinon, il retourne FALSE et l’erreur journalisée peut être récupérée en effectuant un appel à GetLastError.
Remarques
Notes
L’en-tête setupapi.h définit SetupDiBuildClassInfoListEx comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
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 |