REGDB_OPTIONS

InstallShield 2019 » InstallScript Language Reference

The REGDB_OPTIONS system variable enables you to set various options for the general registry functions. The following table describes the options that you can specify:

REGDB_OPTIONS

Option

Meaning

REGDB_OPTION_DISABLETEXTSUBS

Disables text substitutions in strings that are passed to registry functions. Use this option when working with registry function strings that contain opening angle brackets (<) and closing angle brackets (>) but that should not be interpreted as text substitutions.

REGDB_OPTION_NO_DELETE_OLD_MAJMIN_VERSION

Prevents the MaintenanceStart function from deleting the legacy values of the following constants:

REGDB_VALUENAME_UNINSTALL_MAJORVERSION (the major version value name under the application uninstallation key), whose value was MajorVersion for installations that were created with InstallShield 2009 and earlier
REGDB_VALUENAME_UNINSTALL_MINORVERSION (the minor version value name under the application uninstallation key), whose value was MinorVersion for installations that were created with InstallShield 2009 and earlier

For more information, see the “Changes to the Major and Minor Version Registry Entries for the Uninstall Key of InstallScript Installations” section in Upgrading Projects from InstallShield 2009 or Earlier.

REGDB_OPTION_WOW64_64KEY

Specifies that all future general registry operations affect the 64-bit parts of the registry instead of the 32-bit parts of the registry (on a 64-bit system). Setting this option on a 32-bit system has no effect.

For more information about installing to 64-bit registry locations, see Targeting 64-Bit Operating Systems with InstallScript Installations.

REGDB_OPTION_USE_DEFAULT_OPTIONS

Resets (clears) all previously set options.

To add options, combine one or more options using bitwise OR (|) operator as shown:

REGDB_OPTIONS = REGDB_OPTIONS | REGDB_OPTION_WOW64_64KEY

To remove options, specify the option to remove using the bitwise AND (&) operator and the bitwise NOT (~) operator as shown:

REGDB_OPTIONS = REGDB_OPTIONS & ~REGDB_OPTION_WOW64_64KEY

Note • When you enable the REGDB_OPTION_WOW64_64KEY option, this affects where registry entries from registry sets are created. For example, if this option is enabled when you call the CreateRegistrySet function, the registry set is created in the 64-bit part of the registry. If you enable this option for the specific 64-bit registry sets you want to install, it is recommended that you then disable the option so other registry entries or sets are not incorrectly created in the 64-bit part of the registry. For more information about installing to 64-bit registry locations, see Targeting 64-Bit Operating Systems with InstallScript Installations.

The InstallScript engine currently does not support installing Add or Remove Programs information for a product in the 64-bit part of the registry; therefore, the REGDB_OPTION_WOW64_64KEY option is not supported for the specific registry functions such as CreateInstallationInfo, MaintenanceStart, RegDBGetItem, RegDBSetItem, RegDBGetAppInfo, RegDBSetAppInfo, and RegGetUninstCmdLine.