SetupDiGetDeviceInfoListDetailA-Funktion (setupapi.h)
Die SetupDiGetDeviceInfoListDetail Funktion ruft Informationen ab, die einem Geräteinformationssatz zugeordnet sind, einschließlich der Klassen-GUID, des Remotecomputerhandle und des Remotecomputernamens.
Syntax
WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);
Parameter
[in] DeviceInfoSet
Ein Handle zum 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 in den folgenden Anmerkungen Abschnitt.
Rückgabewert
Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.
Bemerkungen
Wenn die Parameter gültig sind, legt SetupDiGetDeviceInfoListDetail- Werte in der DeviceInfoSetDetailData--Struktur (mit Ausnahme des cbSize Felds) fest und gibt den Status NO_ERROR zurück.
Ein Aufrufer von SetupDiGetDeviceInfoListDetail- muss DeviceInfoSetDetailData festlegen.cbSize auf Größe von(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 ist, DeviceInfoSetDetailData.ClassGuid- enthält die Klassen-GUID, die dem Geräteinformationssatz oder einer GUID_NULL Struktur zugeordnet ist.
Wenn SetupDiGetDeviceInfoListDetail erfolgreich abgeschlossen ist und der Geräteinformationssatz für ein Remotesystem gilt, 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 der Geräteinformationssatz für den lokalen Computer festgelegt ist, DeviceInfoSetDetailData.RemoteMachineHandle- ist NULL- und DeviceInfoSetDetailData.RemoteMachineName- ist eine leere Zeichenfolge.
Anmerkung
Der header setupapi.h definiert SetupDiGetDeviceInfoListDetail als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |