SetupDiClassGuidsFromNameW, fonction (setupapi.h)
La fonction SetupDiClassGuidsFromName récupère le ou les GUID associés au nom de classe spécifié. Cette liste est basée sur les classes actuellement installées sur le système.
Syntaxe
WINSETUPAPI BOOL SetupDiClassGuidsFromNameW(
[in] PCWSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
Paramètres
[in] ClassName
Nom de la classe pour laquelle récupérer le 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
Fournit un pointeur vers une variable qui reçoit le nombre de GUID associés au nom de classe. Si ce nombre est supérieur à la taille de la mémoire tampon ClassGuidList, le nombre indique la taille du tableau pour stocker toutes les GUID.
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
Appelez SetupDiClassGuidsFromNameEx pour récupérer les GUID de classe d’une classe sur un ordinateur distant.
Note
L’en-tête setupapi.h définit SetupDiClassGuidsFromName 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 |