fonction CM_Open_Device_Interface_Key_ExA (cfgmgr32.h)

Article
11/20/2024

[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Open_Device_Interface_Key à la place.]

La fonction CM_Open_Device_Interface_Key_ExA 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_Key_ExA(
  [in]           LPCSTR         pszDeviceInterface,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkDeviceInterface,
  [in]           ULONG          ulFlags,
  [in, optional] HMACHINE       hMachine
);

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.

[in, optional] hMachine

Handle d’ordinateur fourni par l’appelant, obtenu à partir d’un appel précédent à CM_Connect_Machine.

Remarque L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à compter de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.

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_Ex 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 10 et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	cfgmgr32.h (include Cfgmgr32.h)
bibliothèque	Cfgmgr32.lib

Voir aussi

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey

Partager via