RegSetValueEx

von ActiveVB-Team

Deklaration

Declare Function RegSetValueEx Lib "advapi32.dll" _
                 Alias "RegSetValueExA" ( _
                 ByVal hKey As Long, _
                 ByVal lpValueName As String, _
                 ByVal Reserved As Long, _
                 ByVal dwType As Long, _
                 lpData As Any, _
                 ByVal cbData As Long) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel RegSetValueEx des API-Wikis.

RegSetValueEx setzt einen benannten Wert eines Registry-Unterschlüssels. Unter NT und Win9x kann es für jeden Unterschlüssel mehrere benannte Werte geben.

Parameter
hKey	Der Elternschlüssel des Unterschlüssels, dessen Wert gesetzt 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.
lpValueName	Zeiger auf einen nullterminierten String, der den Namen des Wertes enthält, dessen Namen gesetzt werden sollen. Wenn dieser String leer ist und der Datentyp dwType gleich REG_SZ wird der Inhalt auf den Standardwert von Win 2.1 gesetzt.
Reserved	Reserviert, wird auf Null gesetzt.
dwType	Der Typ der zu speichernden Daten. In der untenstehenden Tabelle fnden Sie eine Auflistung der gültigen Datentypen.
lpData	Zeiger auf die Daten, die in dem Wert gespeichert werden sollen. Daten die in die Registry abgelegt werden, steht nur ein begrenzter Speicher zur Verfügung. Große Werte sollten in Dateien gespeichert werden, ihre Namen in der Registry.
cbData	Länge der zu speichernden Daten, wobei das Terminierungszeichen nicht berücksichtigt wird.

Tabelle 1

Registry Datentypen
REG_BINARY	Binärdaten in beliebigem Format.
REG_DWORD	Eine 32-Bit Zahl im ursprünglichen Format.
REG_DWORD_LITTLE_ENDIAN	Eine 32-Bit Zahl im Little-Endian-Format (wie REG_DWORD ). In diesem Format ist das obere Byte eines Wortes das höherwertige Byte.
REG_DWORD_BIG_ENDIAN	Eine 32-Bit Zahl im Big-Endian-Format (wie REG_DWORD ). In diesem Format ist das untere Byte eines Wortes das höherwertige Byte.
REG_EXPAND_SZ	Ein nullterminierter String, der nicht aufgelöste Verweise auf Umgebungsvariablen enthält (z.B. %PATH%). Win9x erlaubt, daß diese Strings gespeichert werden. Sie werden nicht automatisch expandiert.
REG_LINK	Ein symbolischer Link zu einem anderen Unterschlüssel.
REG_MULTI_SZ	Eine Liste nullterminierter Strings, die durch ein weiteres Nullzeichen beendet wird.
REG_NONE	Ein nicht definierter Typ.
REG_SZ	Ein nullterminierter String.

Tabelle 2

Rückgabewerte
ERROR_SUCCESS	Der Schlüssel wurde erfolgreich geschlossen.
x	Der zugehörige Fehlercode

Tabelle 3

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

Verwandte API-Funktionen
RegCreateKeyEx, RegFlushKey, RegOpenKeyEx, RegQueryValue, RegQueryValueEx, RegSetValue

Zugehörige Tipps

Anwendung nach Neustart automatisch starten [Tipp 0028]
Registry lesen und schreiben, Schlüssel anlegen und löschen [Tipp 0107]
Startseite des IEs beliebig festlegen [Tipp 0327]
Proxyserver des Internet Explorer einstellen [Tipp 0514]
Programm zusammen mit Windows starten [Tipp 0540]
Programm mit Dateiendung assoziieren II [Tipp 0543]
REG_MULTI_SZ Werte in Registry schreiben und lesen [Tipp 0548]
Eigenes Protokoll definieren [Tipp 0563]
Testen, ob eine ActiveX-Dll registriert ist. [Tipp 0637]

Zugehörige Microsoft Knowledge Base Artikel