fonction CM_Open_Device_Interface_KeyW (cfgmgr32.h)
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 |