Sdílet prostřednictvím


CRegKey::Create

Pokud neexistuje jako podklíč volání této metody vytvořit zadaný klíč 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( );

Parametry

  • hKeyParent
    Popisovač otevřené klíče.

  • lpszKeyName
    Určuje název klíče k vytvoření nebo otevření.Tento název musí být podklíč hKeyParent .

  • lpszClass
    Určuje třídu klíč k vytvoření nebo otevření.Výchozí hodnota je REG_NONE.

  • dwOptions
    Možnosti klíče.Výchozí hodnota je REG_OPTION_NON_VOLATILE.Seznam možných hodnot a popisy v RegCreateKeyEx v .

  • samDesired
    Přístup zabezpečení klíče.Výchozí hodnota je KEY_READ | KEY_WRITE.Seznam možných hodnot a popisy v RegCreateKeyEx.

  • lpSecAttr
    Ukazatel SECURITY_ATTRIBUTES struktury, která označuje, zda může být zděděna popisovač klíče podřízeného procesu.Ve výchozím nastavení tento parametr hodnotu NULL (tj popisovač nelze dědit).

  • lpdwDisposition
    [výstup] Hodnotu NULL, pokud získá REG_CREATED_NEW_KEY (Pokud klíč neexistoval a byl vytvořen) nebo REG_OPENED_EXISTING_KEY (Pokud klíč existoval a byl otevřen).

Vrácená hodnota

V případě úspěchu vrátí ERROR_SUCCESS a otevře klíč.Pokud metodu, vrácená hodnota je nenulová chybový kód definovaný v nezdařila.H.

Poznámky

Vytvoření nastaví m_hKey člena ke zpracování tohoto klíče.

Požadavky

Záhlaví: atlbase.h

Viz také

Referenční dokumentace

Třída CRegKey

CRegKey::Open

CRegKey::Close