SetupDiClassNameFromGuidExW, 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 SetupDiClassNameFromGuidExW(
[in] const GUID *ClassGuid,
[out] PWSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCWSTR 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 terminé par 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 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 avec un appel à GetLastError.
Remarques
Notes
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. 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 |