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

Weitere Informationen

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass