CM_Open_DevNode_Key, fonction (cfgmgr32.h)

Article
02/23/2024

La fonction CM_Open_DevNode_Key ouvre une clé de Registre pour obtenir des informations de configuration spécifiques à l’appareil.

Syntaxe

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

Paramètres

[in] dnDevNode

Handle de instance d’appareil fourni par l’appelant lié à l’ordinateur local

[in] samDesired

Accès de sécurité du Registre requis pour la clé demandée.

[in] ulHardwareProfile

Profil matériel à ouvrir si ulFlags inclut CM_REGISTRY_CONFIG. Si cette valeur est égale à zéro, la clé du profil matériel actuel est ouverte.

[in] Disposition

Spécifie la façon dont la clé de Registre doit être ouverte. Il peut s’agir de l’une des valeurs suivantes :

RegDisposition_OpenAlways

Ouvrez la clé si elle existe. Sinon, créez la clé.

RegDisposition_OpenExisting

Ouvrez la clé uniquement si elle existe.

[out] phkDevice

Pointeur vers une clé HKEY qui recevra la clé ouverte en cas de réussite.

[in] ulFlags

Ouvrez les indicateurs de clé de nœud d’appareil. Indique l’étendue et le type de clé de stockage de Registre à ouvrir. Il peut s’agir d’une combinaison des indicateurs suivants :

CM_REGISTRY_HARDWARE

Ouvrez la clé matérielle de l’appareil. Ne pas combiner avec CM_REGISTRY_SOFTWARE.

CM_REGISTRY_SOFTWARE

Ouvrez la clé logicielle de l’appareil. Ne pas combiner avec CM_REGISTRY_HARDWARE.

CM_REGISTRY_USER

Ouvrez la clé par utilisateur pour l’utilisateur actuel. Ne combinez pas avec CM_REGISTRY_CONFIG.

CM_REGISTRY_CONFIG

Ouvrez la clé qui stocke les informations de configuration spécifiques au profil matériel. Ne combinez pas avec CM_REGISTRY_USER.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.

Remarques

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib ; OneCoreUAP.lib sur Windows 10
DLL	CfgMgr32.dll

Voir aussi

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey

Partager via