SetupDiClassNameFromGuidA, fonction (setupapi.h)

Article
11/20/2024

La fonction SetupDiClassNameFromGuid récupère le nom de classe associé à un GUID de classe.

Syntaxe

WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       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 pointée par le paramètre ClassName . La taille maximale, en caractères, d’un nom de classe 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 null demandé. Ce pointeur est facultatif et peut ê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

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 null terminé même s’il est supérieur à MAX_CLASS_NAME_LEN. Toutefois, MAX_CLASS_NAME_LEN est la longueur maximale d’un nom de classe 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 section version INF.

Note

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. 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

Voir aussi

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx

Partager via