Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |