SetupDiDeleteDeviceInfo-Funktion (setupapi.h)
Die SetupDiDeleteDeviceInfo-Funktion löscht ein Geräteinformationselement aus einem Geräteinformationssatz. Diese Funktion löscht das tatsächliche Gerät nicht.
Syntax
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter
[in] DeviceInfoSet
Ein Handle für den Geräteinformationssatz , der das zu löschende Geräteinformationselement enthält.
[in] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die das zu löschende Geräteinformationselement in DeviceInfoSet darstellt.
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 das angegebene Geräteinformationselement verwendet wird (z. B. durch eine Assistentenseite), schlägt die Funktion fehl. In diesem Fall gibt ein Aufruf von GetLastError ERROR_DEVINFO_DATA_LOCKED zurück. Dies geschieht, wenn ein Handle für eine Assistentenseite mit einem Aufruf von SetupDiGetWizardPage abgerufen wird, wobei dieses Geräteinformationselement angegeben ist und das DIWP_FLAG_USE_DEVINFO_DATA-Flag festgelegt ist. Um dieses Geräteinformationselement zu löschen, müssen Sie zuerst das HPROPSHEETPAGE-Handle des Assistenten schließen.
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 |
| DLL | Setupapi.dll |