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

Voir aussi

CM_Delete_Class_Key

SetupDiOpenClassRegKeyEx