Udostępnij za pośrednictwem


CRegKey::Create

Wywołanie tej metody do utworzenia określonego klucza, jeśli nie istnieje jako podklucz 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
    Dojście otwartego klucza.

  • lpszKeyName
    Określa nazwę klucza, należy utworzyć lub otworzyć.Nazwa ta musi być podkluczem hKeyParent.

  • lpszClass
    Określa klasę klucza do utworzenia lub otwarcia.Wartością domyślną jest REG_NONE.

  • dwOptions
    Opcje klucza.Wartością domyślną jest REG_OPTION_NON_VOLATILE.Listę możliwych wartości i opisy, zobacz RegCreateKeyEx w Windows SDK.

  • samDesired
    Zabezpieczeń dostępu do klucza.Wartością domyślną jest KEY_READ | KEY_WRITE.Listę możliwych wartości i opisy, zobacz RegCreateKeyEx.

  • lpSecAttr
    Wskaźnik do SECURITY_ATTRIBUTES strukturę, która wskazuje, czy uchwyt klucza mogą być dziedziczone przez proces podrzędny.Domyślnie ten parametr ma wartość NULL (co oznacza, który nie może być dziedziczona uchwyt).

  • lpdwDisposition
    [out] Jeśli inne niż NULL pobiera REG_CREATED_NEW_KEY (Jeśli klucz nie istniał i został utworzony) lub REG_OPENED_EXISTING_KEY (Jeśli klucz istniał i został otwarty).

Wartość zwracana

Jeśli się powiedzie, zwraca ERROR_SUCCESS i otwiera klucz.Jeśli metoda nie powiedzie się, wartość zwracana jest kod błędu niezerową, zdefiniowany w powiodło się.H.

Uwagi

Tworzenie ustawia m_hKey Członkowskich do realizacji tego klucza.

Wymagania

Nagłówek: atlbase.h

Zobacz też

Informacje

Klasa CRegKey

CRegKey::Open

CRegKey::Close