fonction CM_Open_Class_KeyW (cfgmgr32.h)
La fonction CM_Open_Class_Key ouvre la clé de Registre de la classe d’installation de l’appareil, la clé de Registre de classe d’interface d’appareil ou une sous-clé spécifique d’une classe.
Syntaxe
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
);
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, il retourne l’un des codes d’erreur CR_ préfixés 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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour