Die Community zu .NET und Classic VB.
Menü

RegCreateKeyEx

 von 

Deklaration  

Declare Function RegCreateKeyEx Lib "advapi32.dll" _
                 Alias "RegCreateKeyExA" ( _
                 ByVal hKey As Long, _
                 ByVal lpSubKey As String, _
                 ByVal Reserved As Long, _
                 ByVal lpClass As String, _
                 ByVal dwOptions As Long, _
                 ByVal samDesired As Long, _
                 ByVal lpSecurityAttributes As Any, _
                 phkResult As Long, _
                 lpdwDisposition As Long) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel RegCreateKeyEx des API-Wikis.

RegCreateKeyEx erzeugt oder öffnet einen Unterschlüssel des angegebenen Schlüssel.

Parameter
hKeyDer Schlüssel, unter dem der neue Unterschlüssel erzeugt werden soll. Dabei kann es sich um einen geöffneten Schlüssel oder einen der vor definfierten Hauptschlüssel HKEY_CLASSES_ROOT , HKEY_CURRENT_USER , HKEY_LOCAL_MACHINE , HKEY_USERS, HKEY_PERFORMANCE_DATA , HKEY_CURRENT_CONFIG , HKEY_DYN_DATA handeln.
lpSubKeyZeiger auf einen nullterminierten String, der den Namen des neuen Unterschlüssels enthält. Wenn der Unterschlüssel bereits exisitiert, wird er geöffnet.
ReservedReserviert, immer auf Null setzen.
lpClassZeiger auf einen nullterminierten String, der den Namen der Schlüsselklasse enthält. Wenn der Unterschlüssel bereits existiert, wird dieser Parameter ignoriert.
dwOptionsDie speziellen Speicheroptionen für den Schlüssel.
samDesiredDie Optionen für den Zugriff .
lpSecurityAttributesDie Sicherheitsattribute des Schlüssels. Die Angabe von Null bewirkt, daß die Standardattribute verwendet werden. Standardsicherheitsattribute erlauben nicht, daß Handles eines Prozesses von einem anderen Prozeß geerbt werden. Damit Schlüssel-Handles vererbt werden können, muß das bInheritHandle-Element der Struktur auf True gesettz werden.
phkResultZeiger auf die Position, die das Handle für den neuen Unterschlüssel entgegennimmt.
lpdwDispositionZeiger auf einen Dispositionswert, der anzeigt, ob der Unterschlüssel erzeugt wurde ( REG_CREATED_NEW_KEY ) oder ob ein existierender Unterschlüssel geöffnet wurde ( REG_OPENED_EXISTING_KEY ).

Tabelle 1


Speicheroptionen [dwOptions]
REG_OPTION_VOLATILEDie Daten werden im Schlüssel behalten und nicht auf die Platte geschrieben. Volatile-Schlüssel sind nach dem Herunterfahren des Systems verloren. RegSaveKey sichert die Volatile-Schlüssel nicht.
REG_OPTION_NON_VOLATILEDie Daten sind nicht flüchtig, sondern werden auf der Platte gesichert. Wenn das System neu gestartet wird, bleiben die Schlüssel erhalten. RegSaveKey speichert den Status dieser Schlüssel.

Tabelle 2


Optionen für den Zugriff [samDesired]
KEY_ALL_ACCESS KEY_CREATE_LINK , KEY_READ oder KEY_WRITE
KEY_CREATE_LINKErlaubt das erstllen symbolischer Links für andere Unterschlüssel.
KEY_CREATE_SUB_KEYErlaubt Unterschlüssel zu erzeugen.
KEY_ENUMERATE_SUB_KEYSErlaubt die Auflistung von Unterschlüsseln
KEY_EXECUTE KEY_QUERY_VALUE oder KEY_ENUMERATE_SUB_KEYS
KEY_NOTIFYAktiviert die Änderungsbenachrichtigung (unter Win95/98 nicht unterstützt)
KEY_QUERY_VALUEErlaubt, daß Unterschlüssel abgefragt werden.
KEY_READ KEY_EXECUTE oder KEY_NOTIFY
KEY_SET_VALUEErlaubt, da0 Unterschlüssel geschrieben werden.
KEY_WRITEKEY_CREATE_SUB_KEY oder KEY_SET_VALUE

Tabelle 3


Rückgabewerte
ERROR_SUCCESSDie Funktion wurde erfolgreich ausgeführt.
xDie Fehlernummer.

Tabelle 4


Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
RegCreateKey, RegDeleteKey, RegOpenKey, RegOpenKeyEx, RegSaveKey

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel