Registry Table

[This is preliminary documentation and subject to change.]

The Registry table holds the registry information that the application needs to set in the system registry.

The Registry table has the following columns.

Columns

Registry

The key for this table.

Root

The predefined root key for the registry value.

Value	Meaning
0	HKEY_CLASSES_ROOT
1	HKEY_CURRENT_USER
2	HKEY_LOCAL_MACHINE
3	HKEY_USERS

Key

The key for the registry value.

Name

The registry value name. If Null, the data entered into the Value column are written to the default registry key.

If the Value column is Null, the strings shown in the following table in the Name column have special significance.

String	Meaning
+	The key is to be created, if absent, when the component is installed.
-	The key is to be deleted, if present, with all of its values and subkeys, when the component is uninstalled.
*	The key is to be created, if absent, when the component is installed. Additionally, the key is to be deleted, if present, with all of its values and subkeys, when the component is uninstalled.

Value

The registry value.

KeyFormatted. If the Value is preceded by a pound symbol (#), the value is interpreted as follows.

String	Meaning
#x	The value is interpreted and stored as a hexadecimal value (REG_BINARY).
#%	The value is interpreted and stored as an expandable string (REG_EXPAND_SZ).
#	The value is interpreted and stored as an integer (REG_INTEGER).

• If the value contains the sequence [~], then the value is interpreted as a Null-delimited list of strings (REG_MULTI_SZ).
• The sequence [~] within the value separates the individual strings and is interpreted and stored as a Null character.
• If a [~] precedes the string list, the strings are to be appended to any existing registry value strings. If an appending string already occurs in the registry value, the original occurrence of the string is removed.
• If a [~] follows the end of the string list, the strings are to be prepended to any existing registry value strings. If a prepending string already occurs in the registry value, the original occurrence of the string is removed.
• If a [~] is at both the beginning and the end or at neither the beginning nor the end of the string list, the strings are to replace any existing registry value strings.
• Otherwise, the value is interpreted and stored as a string (REG_SZ).
• If the value begins with two or more consecutive pound symbols (#), the value is interpreted and stored as a string, ignoring the first #.

Component_

External key into the Component table referencing the component that controls the installation of the registry value.

External key to column one of the Component table.

Remarks

The registry information is written out to the system registry when the corresponding component has been selected to be installed, either locally or run from source.

This table is referred to when the WriteRegistryValues action is executed.