CM_Delete_DevNode_Key-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Delete_DevNode_Key-Funktion löscht die angegebenen Registrierungsschlüssel, auf die ein Gerät zugegriffen werden kann.

Syntax

CMAPI CONFIGRET CM_Delete_DevNode_Key(
  [in] DEVNODE dnDevNode,
  [in] ULONG   ulHardwareProfile,
  [in] ULONG   ulFlags
);

Parameter

[in] dnDevNode

Gerät instance Handle, das an den lokalen Computer gebunden ist.

[in] ulHardwareProfile

Das zu löschende Hardwareprofil, wenn ulFlags CM_REGISTRY_CONFIG enthält. Wenn dieser Wert 0 ist, wird der Schlüssel für das aktuelle Hardwareprofil gelöscht. Wenn dieser Wert 0xFFFFFFFF ist, werden die Registrierungsschlüssel für alle Hardwareprofile gelöscht.

[in] ulFlags

Löschen Sie Geräteknotenschlüsselflags. Gibt den Bereich und den Typ des zu löschenden Registrierungsspeicherschlüssels an. Kann eine Kombination der folgenden Flags sein:

CM_REGISTRY_HARDWARE

Löschen Sie den Hardwareschlüssel des Geräts. Nicht mit CM_REGISTRY_SOFTWARE kombinieren.

CM_REGISTRY_SOFTWARE

Löschen Sie den Softwareschlüssel des Geräts. Nicht mit CM_REGISTRY_HARDWARE kombinieren.

CM_REGISTRY_USER

Löschen Sie den Pro-Benutzer-Schlüssel für den aktuellen Benutzer. Nicht mit CM_REGISTRY_CONFIG kombinieren.

CM_REGISTRY_CONFIG

Löschen Sie den Schlüssel, in dem hardwareprofilspezifische Konfigurationsinformationen gespeichert werden. Nicht mit CM_REGISTRY_USER kombinieren.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Universell
Header cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek Cfgmgr32.lib; OneCoreUAP.lib auf Windows 10
DLL CfgMgr32.dll

Weitere Informationen

CM_Open_DevNode_Key

SetupDiDeleteDevRegKey