SetupDiGetDeviceInfoListDetailA-Funktion (setupapi.h)
Die SetupDiGetDeviceInfoListDetail-Funktion ruft Informationen ab, die einem Geräteinformationssatz zugeordnet sind, einschließlich der Klassen-GUID, des Remotecomputerhandles und des Remotecomputernamens.
Syntax
WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);
Parameter
[in] DeviceInfoSet
Ein Handle für den Geräteinformationssatz , für den Informationen abgerufen werden sollen.
[out] DeviceInfoSetDetailData
Ein Zeiger auf eine vom Aufrufer initialisierte SP_DEVINFO_LIST_DETAIL_DATA Struktur, die die Informationen zum Geräteinformationssatz empfängt. Weitere Informationen zu dieser Struktur finden Sie im abschnitt Hinweise .
Rückgabewert
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.
Hinweise
Wenn die Parameter gültig sind, legt SetupDiGetDeviceInfoListDetail Werte in der DeviceInfoSetDetailData-Struktur fest (mit Ausnahme des Felds cbSize) und gibt status NO_ERROR zurück.
Ein Aufrufer von SetupDiGetDeviceInfoListDetail muss DeviceInfoSetDetail festlegen.cbSize auf sizeof(SP_DEVINFO_LIST_DETAIL_DATA) oder die Funktion schlägt fehl, und der Aufruf von GetLastError gibt ERROR_INVALID_USER_BUFFER zurück.
Wenn SetupDiGetDeviceInfoListDetail erfolgreich abgeschlossen wurde, DeviceInfoSetDetailData.ClassGuid enthält die Klassen-GUID, die dem Geräteinformationssatz oder einer GUID_NULL Struktur zugeordnet ist.
Wenn SetupDiGetDeviceInfoListDetail erfolgreich abgeschlossen wurde und die Geräteinformationen für ein Remotesystem festgelegt sind, deviceInfoSetDetailData.RemoteMachineHandle enthält das ConfigMgr32-Systemhandle für den Zugriff auf das Remotesystem und DeviceInfoSetDetailData.RemoteMachineName enthält den Namen des Remotesystems. Wenn ein Remotehandle für den Geräteinformationssatz vorhanden ist, muss es beim Aufrufen CM_Xxx_Ex-Funktionen verwendet werden, da die DevInst-Handles relativ zum Remotehandle sind.
Wenn die Geräteinformationen für den lokalen Computer festgelegt sind, DeviceInfoSetDetailData.RemoteMachineHandle ist NULL und DeviceInfoSetDetailData.RemoteMachineName ist eine leere Zeichenfolge.
Hinweis
Der setupapi.h-Header definiert SetupDiGetDeviceInfoListDetail als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |