RegCreateKeyEx

von ActiveVB-Team

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
hKey	Der 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.
lpSubKey	Zeiger auf einen nullterminierten String, der den Namen des neuen Unterschlüssels enthält. Wenn der Unterschlüssel bereits exisitiert, wird er geöffnet.
Reserved	Reserviert, immer auf Null setzen.
lpClass	Zeiger auf einen nullterminierten String, der den Namen der Schlüsselklasse enthält. Wenn der Unterschlüssel bereits existiert, wird dieser Parameter ignoriert.
dwOptions	Die speziellen Speicheroptionen für den Schlüssel.
samDesired	Die Optionen für den Zugriff .
lpSecurityAttributes	Die 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.
phkResult	Zeiger auf die Position, die das Handle für den neuen Unterschlüssel entgegennimmt.
lpdwDisposition	Zeiger 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_VOLATILE	Die 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_VOLATILE	Die 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_LINK	Erlaubt das erstllen symbolischer Links für andere Unterschlüssel.
KEY_CREATE_SUB_KEY	Erlaubt Unterschlüssel zu erzeugen.
KEY_ENUMERATE_SUB_KEYS	Erlaubt die Auflistung von Unterschlüsseln
KEY_EXECUTE	KEY_QUERY_VALUE oder KEY_ENUMERATE_SUB_KEYS
KEY_NOTIFY	Aktiviert die Änderungsbenachrichtigung (unter Win95/98 nicht unterstützt)
KEY_QUERY_VALUE	Erlaubt, daß Unterschlüssel abgefragt werden.
KEY_READ	KEY_EXECUTE oder KEY_NOTIFY
KEY_SET_VALUE	Erlaubt, da0 Unterschlüssel geschrieben werden.
KEY_WRITE	KEY_CREATE_SUB_KEY oder KEY_SET_VALUE

Tabelle 3

Rückgabewerte
ERROR_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
x	Die Fehlernummer.

Tabelle 4

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

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

Zugehörige Tipps

Registry lesen und schreiben, Schlüssel anlegen und löschen [Tipp 0107]
Proxyserver des Internet Explorer einstellen [Tipp 0514]
Programm mit Dateiendung assoziieren II [Tipp 0543]
REG_MULTI_SZ Werte in Registry schreiben und lesen [Tipp 0548]
Eigenes Protokoll definieren [Tipp 0563]

Zugehörige Microsoft Knowledge Base Artikel