Partager via


fonction CM_Open_Class_KeyW (cfgmgr32.h)

La fonction CM_Open_Class_Key ouvre la clé de Registre de la classe d’installation de l’appareil, la clé de Registre de classe d’interface d’appareil ou une sous-clé spécifique d’une classe.

Syntaxe

CMAPI CONFIGRET CM_Open_Class_KeyW(
  [in, optional] LPGUID         ClassGuid,
  [in, optional] LPCWSTR        pszClassName,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkClass,
  [in]           ULONG          ulFlags
);

Paramètres

[in, optional] ClassGuid

Pointeur vers le GUID de la classe dont la clé de Registre doit être ouverte. Ce paramètre est facultatif et peut être NULL. Si ce paramètre a la valeur NULL, la racine de l’arborescence de classes est ouverte.

[in, optional] pszClassName

Réservé. Doit être défini sur NULL.

[in] samDesired

Accès de sécurité du Registre pour la clé à ouvrir.

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

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

[in] ulFlags

Ouvrez les indicateurs de clé de classe :

CM_OPEN_CLASS_KEY_INSTALLER

La clé à ouvrir concerne une classe d’installation d’appareil.

CM_OPEN_CLASS_KEY_INTERFACE

La clé à ouvrir concerne une classe d’interface d’appareil.

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.

Configuration requise

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

Voir aussi

CM_Delete_Class_Key

SetupDiOpenClassRegKeyEx