Funktionsreferenz

RegWrite

Erzeugt einen Schlüssel oder Wert in der Registrierung.

RegWrite ( "keyname" [,"valuename" [, "type" [, value]]] )

 

Parameter

keyname Der Registrierungsschlüssel, der geschrieben wird. Wenn keine weiteren Parameter angegeben werden, wird der Schlüssel nur angelegt.
valuename [optional] Der Name des Werts, der geschrieben wird.
type [optional] Typ des Schlüssels, der geschrieben wird: "REG_SZ", "REG_MULTI_SZ", "REG_EXPAND_SZ", "REG_DWORD", "REG_QWORD" oder "REG_BINARY".
value [optional] Der Wert, der geschrieben wird.

 

Rückgabewert

Erfolg: Gibt 1 zurück.
Fehler: Gibt 0 zurück, wenn ein Fehler beim Schreiben des Schlüssels oder Wertes auftritt.
@error kann folgende Werte annehmen:
1 wenn der angegebene Schlüssel nicht geöffnet werden kann
2 wenn der angegebene Hauptschlüssel nicht geöffnet werden kann
3 wenn keine Verbindung per Netzwerk zur Registrierung hergestellt werden kann
-1 wenn der angegebene Wert nicht geöffnet werden kann
-2 wenn der Wertetyp nicht unterstützt wird

 

Bemerkungen

Ein Registrierungsschlüssel muss beginnen mit: "HKEY_LOCAL_MACHINE" ("HKLM") oder "HKEY_USERS" ("HKU") oder "HKEY_CURRENT_USER" ("HKCU") oder "HKEY_CLASSES_ROOT" ("HKCR") oder "HKEY_CURRENT_CONFIG" ("HKCC").

Wenn bei einer 64-bit Windows-Version ein 64-bit spezifischer Wert oder Schlüssel geschrieben werden soll, muss dem Hauptschlüssel HK... ein 64 angehängt werden, z.B. HKLM64.

AutoIt unterstützt Registrierungsschlüssel der Typen REG_BINARY, REG_SZ, REG_MULTI_SZ, REG_EXPAND_SZ, REG_QWORD und REG_DWORD.

Um auf den (Standard) Wert zuzugreifen, muss der Wertname "" (ein Leerstring) sein.

Wenn ein Schlüssel vom Typ REG_MULTI_SZ geschrieben wird, müssen die Werte mit @LF getrennt werden. Der Schlüsselwert darf nicht mit einem @LF enden, es sei denn, man möchte einen leeren Teilstring (siehe das Beispiel).

Es ist möglich, auf Netzwerkregistrierungen zuzugreifen, indem man Schlüsselnamen in der Form "\\Computername\Schlüsselname" verwendet. Um diese Möglichkeit zu nutzen, muss man unter Windows NT/2000/SP/2003 die richtigen Zugriffsrechte besitzen.

 

Verwandte Funktionen

RegDelete, RegRead, RegEnumKey, RegEnumVal

 

Beispiel


; Schreibt einen einzelnen REG_SZ Wert
RegWrite("HKEY_CURRENT_USER\Software\Test", "Test Schlüssel", "REG_SZ", "Hallo dies ist ein Test")

; Schreibt den REG_MULTI_SZ Wert von "Zeile1" und "Zeile2"
RegWrite("HKEY_CURRENT_USER\Software\Test", "Test Schlüssel 1", "REG_MULTI_SZ", "Zeile1" & @LF & "Zeile2")

; Schreibt den REG_MULTI_SZ Wert von "Zeile1"
RegWrite("HKEY_CURRENT_USER\Software\Test", "Test Schlüssel 2", "REG_MULTI_SZ", "Zeile1")

; Fügt immer einen zusätzlichen leeren Null-String an
RegWrite("HKEY_CURRENT_USER\Software\Test", "Test Schlüssel 3", "REG_MULTI_SZ", "Zeile1" & @LF & "Zeile2" & @LF)
RegWrite("HKEY_CURRENT_USER\Software\Test", "Test Schlüssel 4", "REG_MULTI_SZ", "Zeile1" & @LF & @LF & "Zeile2" & @LF)

; Leert REG_MULTI_SZ
RegWrite("HKEY_CURRENT_USER\Software\Test", "Test Schlüssel 5", "REG_MULTI_SZ", "")

; Erstellt nur den Schlüssel
RegWrite("HKEY_CURRENT_USER\Software\Test")