SetupDiCreateDeviceInfoListExA, fonction (setupapi.h)
La fonction SetupDiCreateDeviceInfoList crée un jeu d’informations d’appareil vide sur un ordinateur distant ou local et associe éventuellement l’ensemble à une classe de configuration d’appareil.
Syntaxe
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Paramètres
[in, optional] ClassGuid
Pointeur vers le GUID de la classe de configuration d’appareil à associer au jeu d’informations d’appareil nouvellement créé. Si ce paramètre est spécifié, seuls les appareils de cette classe peuvent être inclus dans ce jeu d’informations sur l’appareil. Si ce paramètre est défini sur NULL, le jeu d’informations sur l’appareil n’est pas associé à une classe de configuration d’appareil spécifique.
[in, optional] hwndParent
Handle vers la fenêtre de niveau supérieur à utiliser pour toute interface utilisateur liée à des actions non spécifiques à l’appareil (par exemple, une boîte de dialogue select-device qui utilise la liste des pilotes de classe globale). Ce handle est facultatif et peut être NULL. Si aucune fenêtre de niveau supérieur spécifique n’est requise, définissez hwndParent sur NULL.
[in, optional] MachineName
Pointeur vers une chaîne terminée par NULL qui contient le nom d’un ordinateur sur un réseau. Si un nom est spécifié, seuls les appareils de cet ordinateur peuvent être créés et ouverts dans cet ensemble d’informations sur l’appareil. Si ce paramètre est défini sur NULL, le jeu d’informations sur l’appareil est destiné aux appareils sur l’ordinateur local.
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 un handle à un jeu d’informations d’appareil vide s’il réussit. Sinon, elle retourne INVALID_HANDLE_VALUE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
L’appelant de cette fonction doit supprimer le jeu d’informations de l’appareil retourné lorsqu’il n’est plus nécessaire en appelant SetupDiDestroyDeviceInfoList.
Si le jeu d’informations sur l’appareil concerne les appareils sur un ordinateur distant (MachineName n’est pas NULL), toutes les opérations suivantes sur ce jeu ou l’un de ses éléments doivent utiliser des routines qui prennent en charge les jeux d’informations d’appareil avec des éléments distants. Les routines SetupDiXxx qui ne fournissent pas cette prise en charge, telles que SetupDiCallClassInstaller, ont une instruction à cet effet dans leur page de référence.
Note
L’en-tête setupapi.h définit SetupDiCreateDeviceInfoListEx 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 |