SetupDiOpenDevRegKey-Funktion (setupapi.h)
Die SetupDiOpenDevRegKey-Funktion öffnet einen Registrierungsschlüssel für gerätespezifische Konfigurationsinformationen.
Syntax
WINSETUPAPI HKEY SetupDiOpenDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType,
[in] REGSAM samDesired
);
Parameter
[in] DeviceInfoSet
Ein Handle für den Geräteinformationssatz , der ein Geräteinformationselement enthält, das das Gerät darstellt, für das ein Registrierungsschlüssel geöffnet werden soll.
[in] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt.
[in] Scope
Der Bereich des zu öffnenden Registrierungsschlüssels. Der Bereich bestimmt, wo die Informationen gespeichert werden. Der Bereich kann global oder spezifisch für ein Hardwareprofil sein. Der Bereich wird durch einen der folgenden Werte angegeben:
DICS_FLAG_GLOBAL
Öffnen Sie einen Schlüssel, um globale Konfigurationsinformationen zu speichern. Diese Informationen beziehen sich nicht auf ein bestimmtes Hardwareprofil. Dadurch wird ein Schlüssel geöffnet, der bei HKEY_LOCAL_MACHINE verwurzelt ist. Der genaue geöffnete Schlüssel hängt vom Wert des KeyType-Parameters ab.
DICS_FLAG_CONFIGSPECIFIC
Öffnen Sie einen Schlüssel, um hardwareprofilspezifische Konfigurationsinformationen zu speichern. Dieser Schlüssel basiert auf einem der hardwareprofilspezifischen Branches und nicht auf HKEY_LOCAL_MACHINE. Der genaue geöffnete Schlüssel hängt vom Wert des KeyType-Parameters ab.
[in] HwProfile
Ein Hardwareprofilwert, der wie folgt festgelegt wird:
- Wenn Bereich auf DICS_FLAG_CONFIGSPECIFIC festgelegt ist, gibt HwProfile das Hardwareprofil des Schlüssels an, der geöffnet werden soll.
- Wenn HwProfile den Wert 0 aufweist, wird der Schlüssel für das aktuelle Hardwareprofil geöffnet.
- Wenn Scope DICS_FLAG_GLOBAL ist, wird HwProfile ignoriert.
[in] KeyType
Der Typ des zu öffnenden Registrierungsspeicherschlüssels, der einer der folgenden Werte sein kann:
DIREG_DEV
Öffnen Sie einen Hardwareschlüssel für das Gerät.
DIREG_DRV
Öffnen Sie einen Softwareschlüssel für das Gerät.
Weitere Informationen zu den Hardware- und Softwareschlüsseln eines Geräts finden Sie unter Registrierungsstrukturen und Schlüssel für Geräte und Treiber.
[in] samDesired
Der Registrierungssicherheitszugriff, der für den angeforderten Schlüssel erforderlich ist. Informationen zu Registrierungssicherheitszugriffswerten des Typs REGSAM finden Sie in der Microsoft Windows SDK-Dokumentation.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Handle an einen geöffneten Registrierungsschlüssel zurückgegeben, in dem private Konfigurationsdaten zu diesem Gerät instance gespeichert/abgerufen werden können.
Wenn die Funktion fehlschlägt, wird INVALID_HANDLE_VALUE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Abhängig vom Wert, der im parameter samDesired übergeben wird, kann es erforderlich sein, dass der Aufrufer dieser Funktion Mitglied der Gruppe Administratoren ist.
Schließen Sie das von dieser Funktion zurückgegebene Handle, indem Sie RegCloseKey aufrufen.
Das angegebene Gerät instance muss registriert werden, bevor diese Funktion aufgerufen wird. Beachten Sie jedoch, dass das Betriebssystem PnP-Geräteinstanzen automatisch registriert. Informationen zum Registrieren von Nicht-PnP-Geräteinstanzen finden Sie unter SetupDiRegisterDeviceInfo.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | DesktopFür universal rufen Sie CM_Open_DevNode_Key auf. |
| Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |
| APIs | ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393) |