SetupDiOpenClassRegKeyExA, fonction (setupapi.h)
La fonction SetupDiOpenClassRegKeyEx ouvre la classe de configuration d’appareil clé de Registre, la classe d’interface d’appareil clé de Registre ou la sous-clé de 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 est NULL, la racine de l’arborescence de classes (HKLM\SYSTEM\CurrentControlSet\Control\Class) est ouverte.
[in] samDesired
Accès de sécurité au Registre pour l’ouverture de la clé. Pour plus d’informations sur les valeurs d’accès de sécurité du Registre de type REGSAM, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows.
[in] Flags
Type de clé de Registre à ouvrir, qui est spécifié par l’une des opérations suivantes :
DIOCR_INSTALLER
Ouvrez une clé de classe d’installation. Si ClassGuid est NULL, ouvrez la clé racine de la branche programme d’installation de classe.
DIOCR_INTERFACE
Ouvrez une clé de classe d’interface. Si ClassGuid est NULL, ouvrez la clé racine de la branche de classe d’interface.
[in, optional] MachineName
Si vous le souhaitez, il pointe vers une chaîne qui contient le nom d’un ordinateur distant sur lequel ouvrir la clé spécifiée.
Prudence
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 de retour
SetupDiOpenClassRegKeyEx retourne un handle à une clé de Registre ouverte où des 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’erreur étendues, appelez GetLastError.
Remarques
Selon la valeur transmise 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 s’il n’existe pas déjà.
Les appelants de cette fonction doivent fermer le handle retourné par cette fonction en appelant RegCloseKey.
Note
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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | setupapi.h (include Setupapi.h) |
| bibliothèque | Setupapi.lib |