SetupDiOpenDeviceInterfaceRegKey, fonction (setupapi.h)

La fonction SetupDiOpenDeviceInterfaceRegKey ouvre la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une interface d’appareil.

Syntaxe

WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved,
  [in] REGSAM                    samDesired
);

Paramètres

[in] DeviceInfoSet

Pointeur vers un jeu d’informations d’appareil qui contient l’interface de l’appareil pour lequel ouvrir une sous-clé de Registre.

[in] DeviceInterfaceData

Pointeur vers une structure SP_DEVICE_INTERFACE_DATA qui spécifie l’interface de l’appareil. Ce pointeur peut être retourné par SetupDiCreateDeviceInterface ou SetupDiEnumDeviceInterfaces.

Reserved

Réservé. Doit être zéro.

[in] samDesired

Accès de sécurité du Registre demandé à la sous-clé de Registre. Pour plus d’informations sur les valeurs d’accès de sécurité du Registre de type REGSAM, consultez la documentation Microsoft Windows SDK.

Valeur retournée

SetupDiOpenDeviceInterfaceRegKey retourne un handle à la clé de Registre ouverte. 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.

Fermez le handle retourné par la fonction en appelant RegCloseKey.

Configuration requise

Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	DesktopPour universel, appelez CM_Open_Device_Interface_Key
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces