Partager via

SetupDiGetDeviceInfoListDetailA, fonction (setupapi.h)

  • Article

La fonction SetupDiGetDeviceInfoListDetail récupère les informations associées à un jeu d’informations d’appareil, notamment le GUID de classe, le handle d’ordinateur distant et le nom de l’ordinateur distant.

Syntaxe

WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
  [in]  HDEVINFO                       DeviceInfoSet,
  [out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);

Paramètres

[in] DeviceInfoSet

Handle de l’ensemble d’informations de l’appareil pour lequel récupérer des informations.

[out] DeviceInfoSetDetailData

Pointeur vers une structure de SP_DEVINFO_LIST_DETAIL_DATA initialisée par l’appelant qui reçoit les informations du jeu d’informations sur l’appareil. Pour plus d’informations sur cette structure, consultez la section Remarques suivante.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, elle retourne FALSE et l’erreur journalisée peut être récupérée en effectuant un appel à GetLastError.

Remarques

Si les paramètres sont valides, SetupDiGetDeviceInfoListDetail définit des valeurs dans la structure DeviceInfoSetDetailData (à l’exception du champ cbSize) et retourne status NO_ERROR.

Un appelant de SetupDiGetDeviceInfoListDetail doit définir DeviceInfoSetDetailData.cbSize à sizeof(SP_DEVINFO_LIST_DETAIL_DATA) ou la fonction échoue et l’appel à GetLastError retourne ERROR_INVALID_USER_BUFFER.

Si SetupDiGetDeviceInfoListDetail se termine correctement, DeviceInfoSetDetailData.ClassGuid contient le GUID de classe associé au jeu d’informations de périphérique ou à une structure GUID_NULL.

Si SetupDiGetDeviceInfoListDetail se termine correctement et que les informations sur l’appareil sont définies pour un système distant, DeviceInfoSetDetailData.RemoteMachineHandle contient le handle système ConfigMgr32 pour accéder au système distant et DeviceInfoSetDetailData.RemoteMachineName contient le nom du système distant. S’il existe un handle distant pour l’ensemble d’informations sur l’appareil, il doit être utilisé lors de l’appelde fonctions CM_Xxx_Ex, car les handles DevInst sont relatifs au handle distant.

Si l’ensemble d’informations sur l’appareil est destiné à l’ordinateur local, DeviceInfoSetDetailData.RemoteMachineHandle a la valeur NULL et DeviceInfoSetDetailData.RemoteMachineName est une chaîne vide.

Notes

L’en-tête setupapi.h définit SetupDiGetDeviceInfoListDetail en tant qu’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. La combinaison 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

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass