SetupDiDeleteDevRegKey-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiCreateDevRegKey

SetupDiGetHwProfileList