SetupDiBuildClassInfoListExA, fonction (setupapi.h)

Article
11/20/2024

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 des 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 duClassGuidList , le nombre indique la taille du tableau ClassGuidList doit être 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 est NULL, cette fonction génère une liste de classes installées sur l’ordinateur local.

Prudence

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 être NULL .

Valeur de retour

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

Remarques

Note

L’en-tête setupapi.h définit SetupDiBuildClassInfoListEx comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	setupapi.h (include Setupapi.h)
bibliothèque	Setupapi.lib

Voir aussi

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

Partager via