SetupDiOpenClassRegKeyExA, fonction (setupapi.h)
La fonction SetupDiOpenClassRegKeyEx ouvre la clé de Registre de la classe d’installation de l’appareil , la clé de Registre de la classe d’interface d’appareil ou la sous-clé d’une classe spécifique. Cette fonction ouvre la clé spécifiée sur l’ordinateur local ou sur un ordinateur distant.
Syntaxe
WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired,
[in] DWORD Flags,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
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 (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.
[in] Flags
Type de clé de Registre à ouvrir, qui est spécifié par l’un des éléments suivants :
DIOCR_INSTALLER
Ouvrez une clé de classe d’installation. Si ClassGuid a la valeur NULL, ouvrez la clé racine de la branche du programme d’installation de classe.
DIOCR_INTERFACE
Ouvrez une clé de classe d’interface. Si ClassGuid a la valeur NULL, ouvrez la clé racine de la branche de classe d’interface.
[in, optional] MachineName
Pointe éventuellement vers une chaîne qui contient le nom d’un ordinateur distant sur lequel ouvrir la clé spécifiée.
Attention
L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.
Reserved
Réservé. Doit être NULL.
Valeur retournée
SetupDiOpenClassRegKeyEx 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.
SetupDiOpenClassRegKeyEx ne crée pas de clé de Registre si elle n’existe pas déjà.
Les appelants de cette fonction doivent fermer le handle retourné par cette fonction en appelant RegCloseKey.
Notes
L’en-tête setupapi.h définit SetupDiOpenClassRegKeyEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
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 | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |