Partager via

fonction CM_Open_Device_Interface_KeyW (cfgmgr32.h)

  • Article

La fonction CM_Open_Device_Interface_Key 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

CMAPI CONFIGRET CM_Open_Device_Interface_KeyW(
  [in]  LPCWSTR        pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

Paramètres

[in] pszDeviceInterface

Pointeur vers une chaîne qui identifie l’interface d’appareil instance pour laquelle ouvrir la sous-clé du Registre.

[in] samDesired

Accès de sécurité du Registre demandé à la sous-clé du Registre.

[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] phkDeviceInterface

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

[in] ulFlags

Réservé. Doit être défini sur zéro.

Valeur retournée

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

Remarques

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

Notes

L’en-tête cfgmgr32.h définit CM_Open_Device_Interface_Key comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Microsoft Windows Vista et les versions ultérieures de Windows.
Plateforme cible Universal
En-tête cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque Cfgmgr32.lib

Voir aussi

SetupDiOpenDeviceInterfaceRegKey