SetupDiOpenClassRegKey-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey