Click here to return to the KiXtart HelpDesk main page...

KiXtart 2001 Manual

WriteValue( )

Action: Assigns a value to a registry entry.
 
Syntax: WRITEVALUE ("subkey", "entry", "expression", "data type")
 
Parameters: Subkey

Identifies the subkey where you want to write a value entry.

Entry

The name of the entry. To write to the (default) entry of a key, specify an empty string as the entry name ("").

Expression

The data to store as the value of the entry.

REG_MULTI_SZ (multi-string) variables are returned with the pipe symbol ( | ) used as the separator between strings. If a string contains a pipe symbol character, it is represented by two pipe symbol characters ( || ).

Data type

Identifies the data type of the entry. The following data types are supported:
REG_NONE
REG_SZ
REG_EXPAND_SZ
REG_BINARY
REG_DWORD
REG_DWORD_LITTLE_ENDIAN
REG_DWORD_BIG_ENDIAN
REG_LINK
REG_MULTI_SZ
REG_RESOURCE_LIST
REG_FULL_RESOURCE_DESCRIPTOR
 

Returns:
0 Value successfully written
Error code Function failed  
 
See Also: AddKey( ), DelKey( ), DelTree( ), ReadType( ), ReadValue( )
 
Example:

$RC=WriteValue("EZReg\Test", "A MultiString variable", "Line 1|Line 2|Line 3 with a || in it|" "REG_MULTI_SZ")
If @ERROR = 0
  ? "Value written to the registry"
Endif