SetupDiGetINFClassW, fonction (setupapi.h)
La fonction SetupDiGetINFClass retourne la classe d’un fichier INF d’appareil spécifié.
Syntaxe
WINSETUPAPI BOOL SetupDiGetINFClassW(
[in] PCWSTR InfName,
[out] LPGUID ClassGuid,
[out] PWSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Paramètres
[in] InfName
Pointeur vers une chaîne terminée par NULL qui fournit le nom d’un fichier INF d’appareil. Ce nom peut inclure un chemin d’accès. Toutefois, si seul le nom du fichier est spécifié, le fichier est recherché dans chaque répertoire répertorié dans l’entrée DevicePath sous la sous-clé HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion du Registre. La longueur maximale en caractères, y compris un terminateur NULL, d’un nom de fichier INF terminé par NULL est MAX_PATH.
[out] ClassGuid
Pointeur vers une variable de type GUID qui reçoit le GUID de classe pour le fichier INF spécifié. Si le fichier INF ne spécifie pas de nom de classe, la fonction retourne une structure GUID_NULL. Appelez SetupDiClassGuidsFromName pour déterminer si une ou plusieurs classes portant ce nom sont déjà installées.
[out] ClassName
Pointeur vers une mémoire tampon qui reçoit une chaîne terminée par NULL qui contient le nom de la classe pour le fichier INF spécifié. Si le fichier INF ne spécifie pas de nom de classe, mais spécifie un GUID, cette mémoire tampon reçoit le nom récupéré en appelant SetupDiClassNameFromGuid. Toutefois, si SetupDiClassNameFromGuid ne peut pas récupérer un nom de classe (par exemple, la classe n’est pas installée), elle retourne une chaîne vide.
[in] ClassNameSize
Taille, en caractères, de la mémoire tampon pointée par le paramètre ClassName
[out, optional] RequiredSize
Pointeur vers une variable typée DWORD qui reçoit le nombre de caractères requis pour stocker le nom de la classe, y compris une NULL de fin. 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
N’utilisez pas cette fonction avec des fichiers INF pour Windows 9x ou Millennium Edition.
Note
L’en-tête setupapi.h définit SetupDiGetINFClass 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 |
| ensemble d’API | ext-ms-win-setupapi-classinstallers-l1-1-2 (introduit dans Windows 10, version 10.0.14393) |