SetupDiClassGuidsFromNameExA, fonction (setupapi.h)
La fonction SetupDiClassGuidsFromNameEx récupère les GUID associés au nom de classe spécifié. Cette liste résultante contient les classes actuellement installées sur un ordinateur local ou distant.
Syntaxe
WINSETUPAPI BOOL SetupDiClassGuidsFromNameExA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Paramètres
[in] ClassName
Nom de la classe pour laquelle récupérer les GUID de classe.
[out] ClassGuidList
Pointeur vers un tableau pour recevoir la liste des GUID associés au nom de classe spécifié.
[in] ClassGuidListSize
Nombre de GUID dans le tableau ClassGuidList .
[out] RequiredSize
Pointeur vers une variable qui reçoit le nombre de GUID associés au nom de la classe. Si ce nombre est supérieur à la taille de la mémoire tampon ClassGuidList , le nombre indique la taille du tableau pour stocker tous les GUID.
[in, optional] MachineName
Pointeur vers une chaîne terminée par NULL qui contient le nom d’un système distant à partir duquel récupérer les GUID. Ce paramètre est facultatif et peut être NULL. Si MachineName a la valeur NULL, le nom du système local est utilisé.
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 être NULL.
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
Il n’est pas garanti que les noms de classe soient uniques ; seuls les GUID sont uniques. Par conséquent, un nom de classe peut retourner plusieurs GUID.
Notes
L’en-tête setupapi.h définit SetupDiClassGuidsFromNameEx en tant qu’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. La combinaison 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 |