CM_Open_DevNode_Key-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Open_DevNode_Key-Funktion öffnet einen Registrierungsschlüssel für gerätespezifische Konfigurationsinformationen.

Syntax

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

Parameter

[in] dnDevNode

Vom Anrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist

[in] samDesired

Der Registrierungssicherheitszugriff, der für den angeforderten Schlüssel erforderlich ist.

[in] ulHardwareProfile

Das Hardwareprofil, das geöffnet werden soll, wenn ulFlags CM_REGISTRY_CONFIG enthält. Wenn dieser Wert 0 ist, wird der Schlüssel für das aktuelle Hardwareprofil geöffnet.

[in] Disposition

Gibt an, wie der Registrierungsschlüssel geöffnet werden soll. Kann einer der folgenden Werte sein:

RegDisposition_OpenAlways

Öffnen Sie den Schlüssel, sofern er vorhanden ist. Erstellen Sie andernfalls den Schlüssel.

RegDisposition_OpenExisting

Öffnen Sie den Schlüssel nur, wenn er vorhanden ist.

[out] phkDevice

Zeiger auf einen HKEY, der den geöffneten Schlüssel nach erfolgreicher Ausführung erhält.

[in] ulFlags

Öffnen Sie Geräteknotenschlüsselflags. Gibt den Bereich und den Typ des zu öffnenden Registrierungsspeicherschlüssels an. Kann eine Kombination der folgenden Flags sein:

CM_REGISTRY_HARDWARE

Öffnen Sie den Hardwareschlüssel des Geräts. Nicht mit CM_REGISTRY_SOFTWARE kombinieren.

CM_REGISTRY_SOFTWARE

Öffnen Sie den Softwareschlüssel des Geräts. Nicht mit CM_REGISTRY_HARDWARE kombinieren.

CM_REGISTRY_USER

Öffnen Sie den Pro-Benutzer-Schlüssel für den aktuellen Benutzer. Nicht mit CM_REGISTRY_CONFIG kombinieren.

CM_REGISTRY_CONFIG

Öffnen 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.

Hinweise

Schließen Sie das von dieser Funktion zurückgegebene Handle, indem Sie RegCloseKey aufrufen.

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_Delete_DevNode_Key

SetupDiOpenDevRegKey