CM_Open_Class_KeyW-Funktion (cfgmgr32.h)

Die funktion CM_Open_Class_Key öffnet den Registrierungsschlüssel der Geräteeinrichtungsklasse, den Registrierungsschlüssel der Geräteschnittstellenklasse oder einen bestimmten Unterschlüssel einer Klasse.

Syntax

CMAPI CONFIGRET CM_Open_Class_KeyW(
  [in, optional] LPGUID         ClassGuid,
  [in, optional] LPCWSTR        pszClassName,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkClass,
  [in]           ULONG          ulFlags
);

Parameter

[in, optional] ClassGuid

Zeiger auf die GUID der Klasse, deren Registrierungsschlüssel geöffnet werden soll. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter NULL ist, wird der Stamm der Klassenstruktur geöffnet.

[in, optional] pszClassName

Reserviert. Muss auf NULL festgelegt werden.

[in] samDesired

Der Registrierungssicherheitszugriff für den zu öffnenden Schlüssel.

[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 vorhanden. Erstellen Sie andernfalls den Schlüssel.

RegDisposition_OpenExisting

Öffnen Sie den Schlüssel nur, wenn er vorhanden ist.

[out] phkClass

Zeiger auf einen HKEY, der den geöffneten Schlüssel bei Erfolg empfängt.

[in] ulFlags

Öffnen Sie Klassenschlüsselflags:

CM_OPEN_CLASS_KEY_INSTALLER

Der zu öffnende Schlüssel gilt für eine Geräteeinrichtungsklasse.

CM_OPEN_CLASS_KEY_INTERFACE

Der zu öffnende Schlüssel gilt für eine Geräteschnittstellenklasse.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Schließen Sie das von dieser Funktion zurückgegebene Handle, indem Sie RegCloseKey aufrufen.

Anforderungen

Weitere Informationen

CM_Delete_Class_Key

SetupDiOpenClassRegKeyEx