fonction CM_Open_Device_Interface_KeyA (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 de périphérique.
CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
[in] LPCSTR pszDeviceInterface,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkDeviceInterface,
[in] ULONG ulFlags
);
[in] pszDeviceInterface
Pointeur vers une chaîne qui identifie l’instance d’interface de l’appareil pour laquelle ouvrir la sous-clé de Registre.
[in] samDesired
Accès de sécurité au Registre demandé à la sous-clé de 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 :
Ouvrez la clé s’il existe. Sinon, créez la clé.
Ouvrez la clé uniquement s’il 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.
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.
Fermez le handle retourné par cette fonction en appelant RegCloseKey.
Notes
L’en-tête cfgmgr32.h définit CM_Open_Device_Interface_Key en tant qu’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.
Exigence | Valeur |
---|---|
client minimum pris en charge | Disponible dans Microsoft Windows Vista et versions ultérieures de Windows. |
plateforme cible | Universel |
d’en-tête | cfgmgr32.h (include Cfgmgr32.h) |
bibliothèque | Cfgmgr32.lib |