SetupDiGetDeviceInfoListDetailW-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 SetupDiGetDeviceInfoListDetailW(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_LIST_DETAIL_DATA_W 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 folgenden 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 DeviceInfoSetDetailData 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 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 |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
Zielplattform | Desktop |
Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
Bibliothek | Setupapi.lib |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für