CM_Open_DevNode_Key-Funktion (cfgmgr32.h)

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

Weitere Informationen

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey