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
| 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 |