Freigeben über


CRegKey::Create

Rufen Sie diese Methode auf, um den angegebenen Schlüssel zu erstellen, wenn er nicht als Unterschlüssel von hKeyParent vorhanden ist.

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( );

Parameter

  • hKeyParent
    Das Handle einer geöffneten Schlüssel.

  • lpszKeyName
    Gibt den Namen einer erstellt sein an oder geöffnet wurde, Schlüssel. Dieser Name muss ein Unterschlüssel von hKeyParent sein.

  • lpszClass
    Gibt die Klasse der erstellt sein an oder geöffnet wurde, Schlüssel. Der Standardwert ist REG_NONE.

  • dwOptions
    Optionen für den Schlüssel. Der Standardwert ist REG_OPTION_NON_VOLATILE. Eine Liste der möglichen Werten oder Beschreibungen, finden Sie unter RegCreateKeyEx in Windows SDK.

  • samDesired
    Der Sicherheitszugriff für den Schlüssel. Der Standardwert ist KEY_READ | KEY_WRITE. Eine Liste der möglichen Werten oder Beschreibungen, finden Sie unter RegCreateKeyEx.

  • lpSecAttr
    Ein Zeiger auf eine Struktur SECURITY_ATTRIBUTES, die angibt, ob das Handle der Schlüssel durch einen untergeordneten Prozess geerbt werden kann. Standardmäßig ist dieser Parameter NULL (das Bedeutung des Handles kann nicht vererbt werden).

  • lpdwDisposition
    [out] Wenn NULL, entweder REG_CREATED_NEW_KEY abruft (wenn der Schlüssel nicht vorhanden und erstellt wurde) oder REG_OPENED_EXISTING_KEY (wenn der Schlüssel vorhanden und geöffnet war).

Rückgabewert

Wenn erfolgreich, gibt ERROR_SUCCESS und öffnet die. Wenn die Methode fehlschlägt, ist der Rückgabewert ein Fehlercode ungleich 0 (null), der in WINERROR.H. definiert ist.

Hinweise

Create legt den m_hKey-Member in Anspruch dieser Schlüssel fest.

Anforderungen

Header: atlbase.h

Siehe auch

Referenz

CRegKey Class

CRegKey::Open

CRegKey::Close