SetupDiRemoveDeviceInterface-Funktion (setupapi.h)
Die SetupDiRemoveDeviceInterface-Funktion entfernt eine registrierte Geräteschnittstelle aus dem System.
Syntax
WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Parameter
[in] DeviceInfoSet
Ein Zeiger auf den Geräteinformationssatz , der die zu entfernende Geräteschnittstelle enthält. Dieses Handle wird in der Regel von SetupDiGetClassDevs zurückgegeben.
[in, out] DeviceInterfaceData
Ein Zeiger auf eine SP_DEVICE_INTERFACE_DATA-Struktur , die die zu entfernende Geräteschnittstelle in DeviceInfoSet angibt. Dieser Zeiger wird in der Regel von SetupDiEnumDeviceInterfaces zurückgegeben.
Nachdem die Schnittstelle entfernt wurde, legt diese Funktion das SPINT_REMOVED-Flag in DeviceInterfaceData fest. Flags. Außerdem wird das flag SPINT_ACTIVE gelöscht. Beachten Sie jedoch, dass dieses Flag bereits vor dem Aufruf dieser Funktion gelöscht worden sein sollte.
Rückgabewert
SetupDiRemoveDeviceInterface gibt TRUE zurück, wenn die Funktion ohne Fehler abgeschlossen wurde. Wenn die Funktion mit einem Fehler abgeschlossen wurde, gibt sie FALSE zurück, und der Fehlercode für den Fehler kann durch Aufrufen von GetLastError abgerufen werden.
Hinweise
Der Aufrufer dieser Funktion muss Mitglied der Gruppe Administratoren sein.
SetupDiRemoveDeviceInterface entfernt die angegebene Geräteschnittstelle aus dem System. Dies schließt das Löschen des zugeordneten Registrierungsschlüssels ein.
Rufen Sie SetupDiDeleteDeviceInterfaceData auf, um die Schnittstelle aus einer Geräteinformationsliste zu löschen.
Eine Geräteschnittstelle muss deaktiviert sein, damit sie entfernt werden kann. Wenn die Schnittstelle aktiviert ist, schlägt diese Funktion fehl, und GetLastError gibt ERROR_DEVICE_INTERFACE_ACTIVE zurück. Deaktivieren Sie eine Schnittstelle, indem Sie einen beliebigen schnittstellenspezifischen Mechanismus verwenden (z. B. eine IOCTL). Wenn der Aufrufer keine Möglichkeit hat, eine Schnittstelle zu deaktivieren und die Schnittstelle entfernt werden muss, muss der Aufrufer das zugrunde liegende Gerät mithilfe von SetupDiChangeState beenden. Durch das Beenden des Geräts werden alle Schnittstellen deaktiviert, die vom Gerät verfügbar gemacht werden.
Anforderungen
| 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 |