Partager via


CRegKey::Open

Appelez cette méthode pour ouvrir la clé spécifiée et définissez m_hKey au handle de cette clé.

LONG Open( 
   HKEY hKeyParent, 
   LPCTSTR lpszKeyName, 
   REGSAM samDesired = KEY_READ | KEY_WRITE 
) throw( );

Paramètres

  • hKeyParent
    Le handle d'une clé ouverte.

  • lpszKeyName
    Spécifie le nom d'une clé à créer ou être ouverte. Ce nom doit être une sous-clé d' hKeyParent.

  • samDesired
    l'accès de sécurité pour la clé. La valeur par défaut est KEY_ALL_ACCESS. Pour obtenir la liste des valeurs possibles et des descriptions, consultez RegCreateKeyEx dans Kit de développement logiciel Windows.

Valeur de retour

En cas de réussite, retourne ERROR_SUCCESS ; sinon, une valeur d'erreur non nulle définie dans WINERROR.H.

Notes

Si le paramètre d' lpszKeyName est NULL ou pointe vers une chaîne vide, Ouvrir ouvre un nouveau handle de la clé identifiée par hKeyParent, mais ne ferme pas tout handle ouvert précédemment.

Contrairement à CRegKey::Create, Ouvrir ne créera pas la clé spécifiée si elle n'existe pas.

Configuration requise

Header: atlbase.h

Voir aussi

Référence

CRegKey, classe

CRegKey::Close