SetupDiGetSelectedDevice-Funktion (setupapi.h)
Die SetupDiGetSelectedDevice-Funktion ruft das ausgewählte Geräteinformationselement in einem Geräteinformationssatz ab.
Syntax
WINSETUPAPI BOOL SetupDiGetSelectedDevice(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter
[in] DeviceInfoSet
Ein Handle für den Geräteinformationssatz , für den das ausgewählte Geräteinformationselement abgerufen werden soll.
[out] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die Informationen zum ausgewählten Geräteinformationselement für DeviceInfoSet empfängt. Der Aufrufer muss DeviceInfoData festlegen.cbSize auf sizeof(SP_DEVINFO_DATA). Wenn ein Gerät derzeit nicht ausgewählt ist, schlägt die Funktion fehl, und ein Aufruf von GetLastError gibt ERROR_NO_DEVICE_SELECTED zurück.
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
SetupDiGetSelectedDevice wird in der Regel von einem Installations-Assistenten verwendet.
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 |