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

Voir aussi

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey