Installer.RegistryValue Method

Windows Installer

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

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

This method does not return a value.

Requirements

VersionWindows Installer 5.0 on 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, Windows XP, and Windows 2000
DLLMsi.dll
IIDIID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.