The RegistryValue method of the Installer object reads information about a specified registry key of value. If the key or value specified does not exist, the method returns an error of 9, "Subscript out of Range."

Syntax

Script
RegistryValue(
  root,
  key,
  value
)

Parameters

root

In Windows NT 4.0, the registry root is either a numeric root key or a machine name as a string. Machine names are always strings. In Windows 95, Windows 98, or Windows Me, the registry root is a numeric root key only. You can only access HKLM on a remote machine.

Root	Meaning
HKEY_CLASSES_ROOT	0
HKEY_CURRENT_USER	1
HKEY_LOCAL_MACHINE	2
HKEY_USERS	3
HKEY_PERFORMANCE_DATA	4
HKEY_CURRENT_CONFIG	5
HKEY_DYN_DATA	6

 

key

A string containing the complete key path from the root. On Windows 95, Windows 98, or Windows Me, registry key class names are not supported and cannot be used.

value

This optional parameter designates which associated value to return for the specified key. The value is one of the values shown in the following table.

Value	Meaning
Missing or blank	Returns a Boolean designating whether the key exists.
String	Returns the data associated with the named value, fails if the value name is non-existent.
Positive integer	Returns the 1-based enumerated value name, it is empty if non-existent. This option uses the RegEnumValue function.
Negative integer	Returns the 1-based enumerated subkey name, this is empty if non-existent. This option uses the RegEnumKey function.
Zero integer	Returns the string class name for the designated key.
Empty string " "	Returns the default value of the registry key.

 

Return Value

Requirements

Send comments about this topic to Microsoft

Build date: 8/13/2009