CM_Open_Class_KeyA, fonction (cfgmgr32.h)
La fonction CM_Open_Class_Key ouvre la clé de Registre de la classe de configuration de l’appareil, la clé de Registre de la classe d’interface de périphérique ou une sous-clé spécifique d’une classe.
Syntaxe
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
);
Paramètres
[in, optional] ClassGuid
Pointeur vers le GUID de la classe dont la clé de Registre doit être ouverte. Ce paramètre est facultatif et peut être NULL. Si ce paramètre a la valeur NULL, la racine de l’arborescence de classes est ouverte.
[in, optional] pszClassName
Réservé. Doit être défini sur NULL.
[in] samDesired
Accès de sécurité du Registre pour la clé à ouvrir.
[in] Disposition
Spécifie la façon dont la clé de Registre doit être ouverte. Il peut s’agir de l’une des valeurs suivantes :
RegDisposition_OpenAlways
Ouvrez la clé si elle existe. Sinon, créez la clé.
RegDisposition_OpenExisting
Ouvrez la clé uniquement si elle existe.
[out] phkClass
Pointeur vers une clé HKEY qui recevra la clé ouverte en cas de réussite.
[in] ulFlags
Ouvrez les indicateurs de clé de classe :
CM_OPEN_CLASS_KEY_INSTALLER
La clé à ouvrir concerne une classe d’installation d’appareil.
CM_OPEN_CLASS_KEY_INTERFACE
La clé à ouvrir concerne une classe d’interface d’appareil.
Valeur retournée
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.
Remarques
Fermez le handle retourné par cette fonction en appelant RegCloseKey.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib |