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 |