SetupDiDeleteDevRegKey-Funktion (setupapi.h)
Die SetupDiDeleteDevRegKey-Funktion löscht die angegebenen registrierungsrelevanten Schlüssel, die einem Geräteinformationselement zugeordnet sind.
Syntax
WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType
);
Parameter
[in] DeviceInfoSet
Ein Handle für den Geräteinformationssatz , der ein Geräteinformationselement enthält, das das Gerät darstellt, für das Registrierungsschlüssel gelöscht werden sollen. Der Geräteinformationssatz darf keine Remoteelemente enthalten.
[in] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt.
[in] Scope
Der Bereich des zu löschenden Registrierungsschlüssels. Der Bereich gibt an, wo sich die Informationen befinden. Der Schlüssel kann global oder hardwareprofilspezifisch sein. Folgenden Werte sind möglich:
DICS_FLAG_GLOBAL
Löschen Sie den Schlüssel, in dem globale Konfigurationsinformationen gespeichert werden.
DICS_FLAG_CONFIGSPECIFIC
Löschen Sie den Schlüssel, in dem hardwareprofilspezifische Konfigurationsinformationen gespeichert werden.
[in] HwProfile
Wenn Bereich auf DICS_FLAG_CONFIGSPECIFIC festgelegt ist, gibt der HwProfile-Parameter das Hardwareprofil an, für das der Registrierungsschlüssel gelöscht werden soll. Wenn HwProfile 0 ist, wird der Schlüssel für das aktuelle Hardwareprofil gelöscht. Wenn HwProfile 0xFFFFFFFF ist, wird der Registrierungsschlüssel für alle Hardwareprofile gelöscht.
[in] KeyType
Der Typ des zu löschenden Registrierungsspeicherschlüssels. Folgenden Werte sind möglich:
DIREG_DEV
Löschen Sie den Hardwareschlüssel des Geräts.
DIREG_DRV
Löschen Sie den Softwareschlüssel des Geräts.
DIREG_BOTH
Löschen Sie sowohl die Hardware- als auch die Softwareschlüssel für das Gerät.
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
Der Aufrufer dieser Funktion muss Mitglied der Gruppe Administratoren sein.
DeviceInfoSet darf nur Elemente auf dem lokalen Computer enthalten.
Anforderungen
| 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 |