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 |
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
