Fonction SetupDiCreateDeviceInterfaceRegKeyA (setupapi.h)
La fonction SetupDiCreateDeviceInterfaceRegKey crée une clé de Registre pour stocker des informations sur une interface d’appareil et retourne un handle à la clé.
Syntaxe
WINSETUPAPI HKEY SetupDiCreateDeviceInterfaceRegKeyA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired,
[in, optional] HINF InfHandle,
[in, optional] PCSTR InfSectionName
);
Paramètres
[in] DeviceInfoSet
Handle d’un jeu d’informations d’appareil qui contient l’interface pour laquelle créer une clé de Registre. Le jeu d’informations sur l’appareil ne doit pas contenir d’éléments distants.
[in] DeviceInterfaceData
Pointeur vers une structure de SP_DEVICE_INTERFACE_DATA qui spécifie l’interface de l’appareil dans DeviceInfoSet. Ce pointeur est éventuellement retourné par SetupDiCreateDeviceInterface.
Reserved
Réservé. Doit être zéro.
[in] samDesired
Accès de sécurité du Registre que l’appelant demande pour la clé en cours de création. 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, optional] InfHandle
Handle d’un fichier INF ouvert qui contient une section DDInstall à exécuter pour la clé nouvellement créée. Ce paramètre est facultatif et peut être NULL. Si ce paramètre n’est pas NULL, InfSectionName doit également être spécifié.
[in, optional] InfSectionName
Pointeur vers le nom d’une section INF DDInstall dans le fichier INF spécifié par InfHandle. Cette section est exécutée pour la clé nouvellement créée. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, InfHandle doit également être spécifié.
Valeur retournée
Si SetupDiCreateDeviceInterfaceRegKey réussit, la fonction retourne un handle à la clé de Registre demandée dans laquelle les informations d’interface peuvent être stockées et récupérées. Si SetupDiCreateDeviceInterfaceRegKey échoue, la fonction retourne INVALID_HANDLE_VALUE. Appelez GetLastError pour obtenir des informations d’erreur étendues.
Remarques
L’appelant de cette fonction doit être membre du groupe Administrateurs.
Si la clé demandée pour l’interface de l’appareil existe déjà, SetupDiCreateDeviceInterfaceRegKey retourne un handle à cette clé ; sinon, SetupDiCreateDeviceInterfaceRegKey crée une nouvelle clé de Registre non volatile pour l’interface d’appareil spécifiée. Les appelants de cette fonction peuvent stocker des données de configuration privées pour l’interface de l’appareil dans cette clé. Le pilote de l’appareil peut accéder à cette clé à l’aide de routines IoXxx .
Fermez le handle retourné par cette fonction en appelant RegCloseKey.
Pour les installations qui utilisent des fichiers de disposition (spécifiés par l’entrée LayoutFile dans une section Inf Version), le fichier de disposition doit être ouvert par un appel à SetupOpenAppendInfFile (décrit dans SDK Windows documentation) avant que SetupDiCreateDeviceInterfaceRegKey soit appelé.
Le jeu d’informations sur l’appareil spécifié par DeviceInfoSet ne doit contenir que des éléments sur l’ordinateur local.
Notes
L’en-tête setupapi.h définit SetupDiCreateDeviceInterfaceRegKey comme un 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.
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 |