Registry Comparison Condition Settings

InstallShield 2015

Project: This information applies to the following project types:

•

Advanced UI

•

Suite/Advanced UI

Edition: The Advanced UI project type is available in the Professional edition of InstallShield. The Suite/Advanced UI project type is available in the Premier edition of InstallShield. For information about the differences between these two project types, see Advanced UI Projects vs. Suite/Advanced UI Projects.

When you are building a conditional statement for an exit, detection, eligibility, or feature condition in an Advanced UI or Suite/Advanced UI project, or for an action condition in a Suite/Advanced UI project, you can create a Registry Comparison condition.

The Registry Comparison setting shows the condition that is configured for checking target systems for specific information—DWORD, QWORD, string, multistring, file version, or product version—for a particular registry entry. If you do not specify a value name, the default value for the key that you specify is used for the comparison. To define this type of condition, configure the subsettings under the Registry Comparison setting as needed.

The following subsettings are available for this condition.

Registry Comparison Condition Settings

Setting

Description

Registry Key

To create a conditional statement that checks for specific information for a particular value name of a registry key, select the appropriate root key in this setting, and then enter the rest of the registry path. Available root keys are:

•

HKLM—HKEY_LOCAL_MACHINE

•

HKCU—HKEY_CURRENT_USER

•

HKCR—HKEY_CLASSES_ROOT

•

HKU—HKEY_USERS

Value Name

Enter the registry value that you want to check for the registry comparison condition. If you want to check the registry key’s default value, leave this setting blank.

64-Bit Key

Specify whether you want the Advanced UI or Suite/Advanced UI installation to check the 64-bit portion of the registry on 64-bit systems. If you select True, the Advanced UI or Suite/Advanced UI installation ignores this conditional statement on 32-bit target systems.

Conversion

Select the type of value that you want to compare. Available options are:

•

DWORD—The value that you want to compare is a DWORD (32-bit) value.

•

QWORD—The value that you want to compare is a QWORD (64-bit) value.

•

String—The value that you want to compare is a string value.

•

Multistring—The value that you want to compare is a multistring value.

•

File Version—The value that you want to compare is a file version value in the format nn.nn.nn.nn.

•

Product Version—The value that you want to compare is a product version value. The typical format for the version number is aaa.bbb.ccccc or aaa.bbb.ccccc.ddddd, where aaa represents the major version number, bbb represents the minor version number, ccccc represents the build number, and ddddd represents the revision number. Note that although you can include the fourth field (ddddd) when you specify the product version, the Advanced UI or Suite/Advanced UI installation does not use this part of the product version to distinguish between different product versions.

Comparison

Select the option that describes how you want to compare the value on the target system with the value that you specify in the Compare To setting. For example, consider a registry condition in which the value of the Comparison setting is Less Than or Equal To, and the value of the Compare To setting is 4.1. At run time, this condition evaluates as true if the number in the specified registry value data on the target system is 4.0 or 4.1; it evaluates as false if the version on the target system is 4.2.

Compare To

Specify the value that you want to compare with the value on the target system. The value that you enter depends on the option that is selected for the Conversion setting:

•

If DWORD is selected in the Conversion setting, enter the DWORD value that you want to compare in the Compare To setting.

•

If QWORD is selected in the Conversion setting, enter the QWORD value that you want to compare in the Compare To setting.

•

If String is selected in the Conversion setting, enter the string value that you want to compare in the Compare To setting.

•

If MultiString is selected in the Conversion setting, enter the multistring value that you want to compare in the Compare To setting.

•

If File Version is selected in the Conversion setting, enter the file version value (in the format nn.nn.nn.nn) that you want to compare in the Compare To setting.

Compare To (continued)

•

If Product Version is selected in the Conversion setting, enter the product version value that you want to compare in the Compare To setting. The typical format for the version number is aaa.bbb.ccccc or aaa.bbb.ccccc.ddddd, where aaa represents the major version number, bbb represents the minor version number, ccccc represents the build number, and ddddd represents the revision number. Note that although you can include the fourth field (ddddd) when you specify the product version, the Advanced UI or Suite/Advanced UI installation does not use this part of the product version to distinguish between different product versions.

When you type a value for this setting, you can include one or more formatted expressions that contain property names, environment variable references, and other special strings; at run time, the installation expands the values of these expressions. To learn about the syntax that is available for these expressions, see Using Formatted Expressions that Advanced UI and Suite/Advanced UI Installations Resolve at Run Time.

The Comparison setting is where you indicate how you want to compare the value on the target system with the value that you specify in the Compare To setting. For example, consider a registry condition in which the value of the Comparison setting is Less Than or Equal To, and the value of the Compare To setting is 4.1. At run time, this condition evaluates as true if the number in the specified registry value data on the target system is 4.0 or 4.1; it evaluates as false if the version on the target system is 4.2.

Registry Comparison Condition Settings

InstallShield 2015 Help Library

June 2015