SetupDiClassNameFromGuidExA, fonction (setupapi.h)
La fonction SetupDiClassNameFromGuidEx récupère le nom de classe associé à un GUID de classe. La classe peut être installée sur un ordinateur local ou distant.
Syntaxe
WINSETUPAPI BOOL SetupDiClassNameFromGuidExA(
[in] const GUID *ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Paramètres
[in] ClassGuid
GUID de classe du nom de classe à récupérer.
[out] ClassName
Pointeur vers une mémoire tampon de chaîne qui reçoit le nom null de la classe pour le GUID spécifié.
[in] ClassNameSize
Taille, en caractères, de la mémoire tampon ClassName
[out, optional] RequiredSize
Nombre de caractères requis pour stocker le nom de la classe (y compris une valeur null de fin). RequiredSize est toujours inférieur à MAX_CLASS_NAME_LEN.
[in, optional] MachineName
Pointeur vers une chaîne terminée par NULL qui contient le nom d’un système distant sur lequel la classe est installée. Ce paramètre est facultatif et peut être NULL. Si MachineName est NULL, le nom du système local est utilisé.
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 avec un appel à GetLastError.
Remarques
Note
L’en-tête setupapi.h définit SetupDiClassNameFromGuidEx 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 |