Partager via


CRegKey::Create

Appelez cette méthode pour créer la clé spécifiée, si elle n'existe pas comme valeur d' hKeyParent.

LONG Create( 
   HKEY hKeyParent, 
   LPCTSTR lpszKeyName, 
   LPTSTR lpszClass = REG_NONE, 
   DWORD dwOptions = REG_OPTION_NON_VOLATILE, 
   REGSAM samDesired = KEY_READ | KEY_WRITE, 
   LPSECURITY_ATTRIBUTES lpSecAttr = NULL, 
   LPDWORD lpdwDisposition = NULL  
) 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.

  • lpszClass
    Spécifie la classe de la clé à créer ou être ouverte. La valeur par défaut est REG_NONE.

  • dwOptions
    Options pour la clé. La valeur par défaut est REG_OPTION_NON_VOLATILE. Pour obtenir la liste des valeurs possibles et des descriptions, consultez RegCreateKeyEx dans Kit de développement logiciel Windows.

  • samDesired
    l'accès de sécurité pour la clé. La valeur par défaut est KEY_READ | KEY_WRITE. Pour obtenir la liste des valeurs possibles et des descriptions, consultez RegCreateKeyEx.

  • lpSecAttr
    Un pointeur vers une structure de SECURITY_ATTRIBUTES qui indique si le handle de la clé peut être héritée par un processus enfant. Par défaut, ce paramètre est NULL (indiquer le handle ne peut pas être héritée).

  • lpdwDisposition
    [out] Si non null, extrait REG_CREATED_NEW_KEY (si la clé n'existait pas et a été créée) ou REG_OPENED_EXISTING_KEY (si la clé existait et a été ouverte).

Valeur de retour

En cas de réussite, retourne ERROR_SUCCESS et ouvre la clé. Si la méthode échoue, la valeur de retour est un code d'erreur différent de zéro défini dans WINERROR.H.

Notes

Créer définit m_hKey membre au handle de cette clé.

Configuration requise

Header: atlbase.h

Voir aussi

Référence

CRegKey, classe

CRegKey::Open

CRegKey::Close