SetupDiOpenClassRegKey-Funktion (setupapi.h)
Die SetupDiOpenClassRegKey-Funktion öffnet den Registrierungsschlüssel der Setupklasse oder den Unterschlüssel einer bestimmten Klasse.
Syntax
WINSETUPAPI HKEY SetupDiOpenClassRegKey(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired
);
Parameter
[in, optional] ClassGuid
Ein Zeiger auf die GUID der Setupklasse, deren Schlüssel geöffnet werden soll. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter NULL ist, wird der Stamm der Setupklassenstruktur (HKLM\SYSTEM\CurrentControlSet\Control\Class) geöffnet.
[in] samDesired
Der Registrierungssicherheitszugriff für den zu öffnenden Schlüssel. 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 Informationen zu dieser Setupklasse 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.
Diese Funktion erstellt keinen Registrierungsschlüssel, wenn er noch nicht vorhanden ist.
Das von dieser Funktion zurückgegebene Handle muss durch Aufrufen von RegCloseKey geschlossen werden.
Um den Registrierungsschlüssel der Schnittstellenklasse oder einen bestimmten Unterschlüssel der Schnittstellenklasse zu öffnen, rufen Sie SetupDiOpenClassRegKeyEx auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | DesktopFür universal rufen Sie CM_Open_Class_Key auf. |
| Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |