Fonction SetupDiOpenDevRegKey (setupapi.h)
La fonction SetupDiOpenDevRegKey ouvre une clé de Registre pour obtenir des informations de configuration spécifiques à l’appareil.
Syntaxe
WINSETUPAPI HKEY SetupDiOpenDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType,
[in] REGSAM samDesired
);
Paramètres
[in] DeviceInfoSet
Handle du jeu d’informations sur l’appareil qui contient un élément d’informations sur l’appareil qui représente l’appareil pour lequel ouvrir une clé de Registre.
[in] DeviceInfoData
Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet.
[in] Scope
Étendue de la clé de Registre à ouvrir. L’étendue détermine l’emplacement où les informations sont stockées. L’étendue peut être globale ou spécifique à un profil matériel. L’étendue est spécifiée par l’une des valeurs suivantes :
DICS_FLAG_GLOBAL
Ouvrez une clé pour stocker des informations de configuration globale. Ces informations ne sont pas spécifiques à un profil matériel particulier. Cela ouvre une clé qui est enracinée à HKEY_LOCAL_MACHINE. La clé exacte ouverte dépend de la valeur du paramètre KeyType .
DICS_FLAG_CONFIGSPECIFIC
Ouvrez une clé pour stocker des informations de configuration spécifiques au profil matériel. Cette clé est enracinée dans l’une des branches spécifiques au profil matériel, au lieu de HKEY_LOCAL_MACHINE. La clé exacte ouverte dépend de la valeur du paramètre KeyType .
[in] HwProfile
Valeur de profil matériel, qui est définie comme suit :
- Si l’étendue est définie sur DICS_FLAG_CONFIGSPECIFIC, HwProfile spécifie le profil matériel de la clé à ouvrir.
- Si HwProfile est 0, la clé du profil matériel actuel est ouverte.
- Si l’étendue est DICS_FLAG_GLOBAL, HwProfile est ignoré.
[in] KeyType
Type de clé de stockage de Registre à ouvrir, qui peut être l’une des valeurs suivantes :
DIREG_DEV
Ouvrez une clé matérielle pour l’appareil.
DIREG_DRV
Ouvrez une clé logicielle pour l’appareil.
Pour plus d’informations sur les clés matérielles et logicielles d’un appareil, consultez Arborescences et clés du Registre pour les périphériques et les pilotes.
[in] samDesired
Accès de sécurité au Registre requis pour la clé demandée. 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
Si la fonction réussit, elle retourne un handle à une clé de Registre ouverte où les données de configuration privée sur cet appareil instance peuvent être stockées/récupérées.
Si la fonction échoue, elle retourne INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
En fonction de 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 cette fonction en appelant RegCloseKey.
Le instance d’appareil spécifié doit être inscrit avant l’appel de cette fonction. Toutefois, n’oubliez pas que le système d’exploitation enregistre automatiquement les instances d’appareil PnP. Pour plus d’informations sur l’inscription d’instances d’appareil non PnP, consultez SetupDiRegisterDeviceInfo.
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_DevNode_Key |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |
| Ensemble d’API | ext-ms-win-setupapi-classinstallers-l1-1-2 (introduit dans Windows 10, version 10.0.14393) |