Partager via

Fonction SetupDiCreateDeviceInfoListExA (setupapi.h)

  • Article

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 d’installation 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 d’installation de l’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 cet ensemble d’informations d’appareil. Si ce paramètre a la valeur NULL, le jeu d’informations sur l’appareil n’est pas associé à une classe d’installation d’appareil spécifique.

[in, optional] hwndParent

Handle de 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 sélectionner un appareil qui utilise la liste des pilotes de classe globale). Ce handle est facultatif et peut être NULL. Si une fenêtre de niveau supérieur spécifique n’est pas requise, définissez hwndParent surNULL.

[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 sur cet ordinateur peuvent être créés et ouverts dans cet ensemble d’informations d’appareil. Si ce paramètre a la valeur NULL, l’ensemble d’informations sur l’appareil concerne les appareils sur l’ordinateur local.

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 avoir la valeur NULL.

Valeur retournée

La fonction retourne un handle à un jeu d’informations d’appareil vide s’il réussit. Sinon, il retourne INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

L’appelant de cette fonction doit supprimer le jeu d’informations d’appareil retourné quand 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’a pas la valeur NULL), toutes les opérations suivantes sur cet ensemble ou sur l’un de ses éléments doivent utiliser des routines qui prennent en charge les jeux d’informations sur l’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.

Notes

L’en-tête setupapi.h définit SetupDiCreateDeviceInfoListEx 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

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

Voir aussi

SetupDiCreateDeviceInfoList

SetupDiDestroyDeviceInfoList

SetupDiGetDeviceInfoListDetail