CM_Open_Class_KeyA-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_KeyA(
[in, optional] LPGUID ClassGuid,
[in, optional] LPCSTR 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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | cfgmgr32.h (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |