Fonction SetupDiOpenDevRegKey (setupapi.h)

Article
08/26/2023

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)