fonction CM_Open_Device_Interface_KeyA (cfgmgr32.h)

Article
11/20/2024

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.

Syntaxe

CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
  [in]  LPCSTR         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’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 :

RegDisposition_OpenAlways

Ouvrez la clé s’il existe. Sinon, créez la clé.

RegDisposition_OpenExisting

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.

Valeur de retour

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.

Remarques

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

Note

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.

Exigences

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

Voir aussi

SetupDiOpenDeviceInterfaceRegKey

Partager via