SetupDiCreateDeviceInterfaceRegKeyW, fonction (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 SetupDiCreateDeviceInterfaceRegKeyW(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired,
[in, optional] HINF InfHandle,
[in, optional] PCWSTR InfSectionName
);
Paramètres
[in] DeviceInfoSet
Handle vers 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 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 égal à zéro.
[in] samDesired
Accès de sécurité au Registre demandé par l’appelant 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 du Kit de développement logiciel (SDK) Microsoft Windows.
[in, optional] InfHandle
Handle vers 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 DDInstall
Valeur de retour
Si SetupDiCreateDeviceInterfaceReg Key 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 d’appareil existe déjà, SetupDiCreateDeviceInterfaceRegKey retourne un handle à cette clé ; sinon, SetupDiCreateDeviceInterfaceRegKey crée une nouvelle clé de Registre nonvolatile pour l’interface d’appareil spécifiée. Les appelants de cette fonction peuvent stocker des données de configuration privée 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ées par l’entrée LayoutFile dans une section version INF), le fichier de disposition doit être ouvert par un appel à SetupOpenAppendInfFile (décrit dans la documentation du Kit de développement logiciel (SDK) Windows) avant SetupDiCreateDeviceInterfaceRegKey est appelé.
Le jeu d’informations sur l’appareil spécifié par DeviceInfoSet doit contenir uniquement des éléments sur l’ordinateur local.
Note
L’en-tête setupapi.h définit SetupDiCreateDeviceInterfaceRegKey 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 |