Installer.RegistryValue method

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

Installer.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.

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

This method does not return a value.

Requirements

Requirement Value
Version
Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP
DLL
Msi.dll
IID
IID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046