SetupDiDeleteDeviceInterfaceRegKey-Funktion (setupapi.h)
Die SetupDiDeleteDeviceInterfaceRegKey-Funktion löscht den Registrierungsunterschlüssel, der von Anwendungen und Treibern zum Speichern schnittstellenspezifischer Informationen verwendet wird.
Syntax
WINSETUPAPI BOOL SetupDiDeleteDeviceInterfaceRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved
);
Parameter
[in] DeviceInfoSet
Ein Zeiger auf einen Geräteinformationssatz , der die Schnittstelle enthält, für die schnittstellenspezifische Informationen in der Registrierung gelöscht werden sollen. Der Geräteinformationssatz darf keine Remoteelemente enthalten.
[in] DeviceInterfaceData
Ein Zeiger auf eine SP_DEVICE_INTERFACE_DATA Struktur, die die Geräteschnittstelle in DeviceInfoSet angibt. Dieser Zeiger wird möglicherweise von SetupDiCreateDeviceInterface oder SetupDiEnumDeviceInterfaces zurückgegeben.
Reserved
Reserviert. Muss Null sein.
Rückgabewert
SetupDiDeleteDeviceInterfaceRegKey gibt TRUE zurück, wenn es erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.
Hinweise
Der Aufrufer dieser Funktion muss Mitglied der Gruppe Administratoren sein.
SetupDiDeleteDeviceInterfaceRegKey löscht den Unterschlüssel, der von Treibern und Anwendungen zum Speichern von Informationen zur Geräteschnittstelle instance verwendet wird. Dieser Unterschlüssel wurde durch SetupDiCreateDeviceInterfaceRegKey oder durch den Aufruf des Treibers an eine zugeordnete E/A-Managerroutine erstellt. SetupDiDeleteDeviceInterfaceRegKey wirkt sich nicht auf den Standard Registrierungsschlüssel für die Geräteschnittstelle instance oder andere Unterschlüssel aus, die erstellt wurden.
DeviceInfoSet darf nur Elemente auf dem lokalen Computer enthalten.
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 |