SetupDiOpenClassRegKey, fonction (setupapi.h)
La fonction SetupDiOpenClassRegKey ouvre la clé de Registre de la classe setup ou la sous-clé d’une classe spécifique.
Syntaxe
WINSETUPAPI HKEY SetupDiOpenClassRegKey(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired
);
Paramètres
[in, optional] ClassGuid
Pointeur vers le GUID de la classe setup dont la clé 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 classe setup (HKLM\SYSTEM\CurrentControlSet\Control\Class) est ouverte.
[in] samDesired
Accès de sécurité du Registre pour la clé à ouvrir. Pour plus d’informations sur les valeurs d’accès de sécurité du Registre de type REGSAM, consultez la documentation Microsoft Windows SDK.
Valeur retournée
Si la fonction réussit, elle retourne un handle à une clé de Registre ouverte où les informations sur cette classe d’installation peuvent être stockées/récupérées.
Si la fonction échoue, elle retourne INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Selon la valeur passée dans le paramètre samDesired , il peut être nécessaire que l’appelant de cette fonction soit membre du groupe Administrateurs.
Cette fonction ne crée pas de clé de Registre si elle n’existe pas déjà.
Le handle retourné par cette fonction doit être fermé en appelant RegCloseKey.
Pour ouvrir la clé de Registre de la classe d’interface ou une sous-clé de classe d’interface spécifique, appelez SetupDiOpenClassRegKeyEx.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | DesktopPour être universel, appelez CM_Open_Class_Key |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |