SetupDiGetDeviceInfoListDetailW, fonction (setupapi.h)
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 SetupDiGetDeviceInfoListDetailW(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_LIST_DETAIL_DATA_W DeviceInfoSetDetailData
);
Paramètres
[in] DeviceInfoSet
Handle vers le jeu d’informations de l’appareil pour lequel récupérer des informations.
[out] DeviceInfoSetDetailData
Pointeur vers une structure d'SP_DEVINFO_LIST_DETAIL_DATA initialisée par l’appelant qui reçoit les informations du jeu d’informations de l’appareil. Pour plus d’informations sur cette structure, consultez la section suivante Remarques.
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 en effectuant un appel à GetLastError.
Remarques
Si les paramètres sont valides,
Un appelant de SetupDiGetDeviceInfoListDetail doit définir DeviceInfoSetDetailData.cbSize à taille de(SP_DEVINFO_LIST_DETAIL_DATA) ou la fonction échoue et l’appel à GetLastError retourne ERROR_INVALID_USER_BUFFER.
Si SetupDiGetDeviceInfoListDetail s’exécute correctement, DeviceInfoSetDetailData. ClassGuid contient le GUID de classe associé au jeu d’informations d’appareil ou à une structure GUID_NULL.
Si SetupDiGetDeviceInfoListDetail se termine correctement et que le jeu d’informations sur l’appareil est destiné à 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 le jeu d’informations sur l’appareil, il doit être utilisé lors de l’appel d'CM_fonctions xxx_Ex, car les handles DevInst sont relatifs au handle distant.
Si les informations de l’appareil sont définies pour l’ordinateur local, DeviceInfoSetDetailData.RemoteMachineHandle est NULL et DeviceInfoSetDetailData.RemoteMachineName est une chaîne vide.
Note
L’en-tête setupapi.h définit SetupDiGetDeviceInfoListDetail 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 |