SetupDiOpenDevRegKey-Funktion (setupapi.h)

Artikel
08/26/2023

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)