SetupDiDeleteDeviceInterfaceRegKey-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey