SetupDiClassNameFromGuidW, fonction (setupapi.h)
La fonction SetupDiClassNameFromGuid récupère le nom de classe associé à un GUID de classe.
Syntaxe
WINSETUPAPI BOOL SetupDiClassNameFromGuidW(
[in] const GUID *ClassGuid,
[out] PWSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Paramètres
[in] ClassGuid
Pointeur vers le GUID de classe pour le nom de classe à récupérer.
[out] ClassName
Pointeur vers une mémoire tampon qui reçoit la chaîne terminée par NULL qui contient le nom de la classe spécifiée par le pointeur dans le paramètre ClassGuid .
[in] ClassNameSize
Taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre ClassName . La taille maximale, en caractères, d’un nom de classe terminé par NULL est MAX_CLASS_NAME_LEN. Pour plus d’informations sur la taille du nom de classe, consultez la section Remarques suivante.
[out, optional] RequiredSize
Pointeur vers une variable qui reçoit le nombre de caractères requis pour stocker le nom de classe terminé par NULL demandé. Ce pointeur est facultatif et peut ê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 avec un appel à GetLastError.
Remarques
Appelez SetupDiClassNameFromGuidEx pour récupérer le nom d’une classe sur un ordinateur distant.
SetupDiClassNameFromGuid n’applique pas de restriction sur la longueur du nom de classe qu’il peut retourner. Cette fonction retourne la taille requise pour un nom de classe terminé par NULL, même s’il est supérieur à MAX_CLASS_NAME_LEN. Toutefois, MAX_CLASS_NAME_LEN correspond à la longueur maximale d’un nom de classe terminé par NULL valide. Un appelant ne doit jamais avoir besoin d’une mémoire tampon supérieure à MAX_CLASS_NAME_LEN. Pour plus d’informations sur les noms de classes, consultez la description de l’entrée de classe d’une version INF.
Notes
L’en-tête setupapi.h définit SetupDiClassNameFromGuid 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. 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 |