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

Classe de CRegKey

CRegKey::Open

CRegKey::Close