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

Voir aussi

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey