CM_Open_DevNode_Key, fonction (cfgmgr32.h)

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

Voir aussi

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey