RegSetValue

von ActiveVB-Team

Deklaration

Declare Function RegSetValue Lib "advapi32.dll" _
                 Alias "RegSetValueA" ( _
                 ByVal hKey As Long, _
                 ByVal lpSubKey As String, _
                 ByVal dwType As Long, _
                 ByVal lpData As String, _
                 ByVal cbData As Long) As Long

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

RegSetValue belegt einen vorgegebenen Unterschlüssel mit einem Wert. Dieser muß ein String sein und kann keinen Namen haben.
Achtung: Diese Funktion wird nur noch aus Kompatibilitätsgründen zu Win 3.1 mitgeführt. 32-Bit Applikationen sollten unbedingt die RegSetValueEx verwenden.

Parameter
hKey	Das Handle des Schlüssels dem ein Wert zugewiesen 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 Unterschlüssels enthält. Wenn dieser Wert leer bleibt, wird der String dem Standard-Wert des durch hKey benannten Schlüssels zugewiesen.
dwType	Gibt den Wertetyp des zu schreibenden Wertes an. Hier dürfen nur Werte vom Typ REG_SZ genutzt werden, für andere ist die RegSetValueEx zu nutzen.
lpData	Beinhaltet den String der geschrieben werden soll.
cbData	Benennt die Länge des zu schreibenden Strings. Das Terminierungszeichen wird nicht berücksichtigt.

Tabelle 1

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

Tabelle 2

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

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

Zugehörige Tipps

Anwendung mit Dateiendung assoziieren [Tipp 0001]
Parameter an EXE mit Command$ übergeben [Tipp 0062]

Zugehörige Microsoft Knowledge Base Artikel