SetupDiGetDeviceInfoListClass-Funktion (setupapi.h)

  • Artikel

Die SetupDiGetDeviceInfoListClass-Funktion ruft die GUID für die Gerätesetupklasse ab, die einem Geräteinformationssatz zugeordnet ist, wenn die Gruppe über eine zugeordnete Klasse verfügt.

Syntax

WINSETUPAPI BOOL SetupDiGetDeviceInfoListClass(
  [in]  HDEVINFO DeviceInfoSet,
  [out] LPGUID   ClassGuid
);

Parameter

[in] DeviceInfoSet

Ein Handle für die Geräteinformationen , die auf Abfrage festgelegt sind.

[out] ClassGuid

Ein Zeiger auf eine Variable vom Typ GUID, die die GUID für die zugeordnete Klasse empfängt.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.

Hinweise

Wenn dem angegebenen Geräteinformationssatz keine zugeordnete Klasse zugeordnet ist, weil beim Erstellen der Gruppe mit SetupDiCreateDeviceInfoList keine Klassen-GUID angegeben wurde, schlägt die Funktion fehl. In diesem Fall gibt ein Aufruf von GetLastError ERROR_NO_ASSOCIATED_CLASS zurück.

Wenn ein Geräteinformationssatz für einen Remotecomputer gilt, verwenden Sie SetupDiGetDeviceInfoListDetail , um das zugeordnete Remotecomputerhandle und den Computernamen abzurufen.

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
DLL Setupapi.dll

Weitere Informationen

SetupDiCreateDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListDetail