Fonction SetupDiGetINFClassW (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 le nom de 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 qu’il 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), il retourne une chaîne vide.
[in] ClassNameSize
Taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre ClassName . La longueur maximale d’un nom de classe terminé par NULL, en caractères, est MAX_CLASS_NAME_LEN.
[out, optional] RequiredSize
Pointeur vers une variable de type DWORD qui reçoit le nombre de caractères requis pour stocker le nom de la classe, y compris une valeur NULL de fin. Ce pointeur est facultatif et peut avoir la valeur NULL.
Valeur retournée
La fonction retourne TRUE si elle réussit. Sinon, il retourne FALSE 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.
Notes
L’en-tête setupapi.h définit SetupDiGetINFClass comme un 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.
Configuration requise
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Bureau |
| En-tête | setupapi.h (inclure 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) |