Partager via

Fonction SetupDiCreateDeviceInterfaceRegKeyA (setupapi.h)

  • Article

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

Voir aussi

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceRegKey

SetupDiOpenDeviceInterfaceRegKey