Windows Installer Editor Reference
307
Upgrading Applications
Include maximum version in range
Mark this to include the maximum version as a valid upgrade. If you clear this,
only versions below the maximum version are upgraded.
Languages
This determines if an application should be upgraded based on its language.
Enter a semicolon-delimited list of languages that should be upgraded by this
installation. If this is left blank, all languages are included. Example: To upgrade
only the American English version, enter 1033.
See
Language IDs
on page 288.
Exclude languages in list
Mark this to reverse the function of the Languages field, causing this
installation to upgrade only the versions not listed in the Languages field.
Example: To upgrade every version except the American English version, enter
1033 in the Languages field and mark this check box.
Features to remove
If this is left blank, the upgrade removes all existing features from the installed
application, and then installs the features specified in the new installation. To
prevent the removal of a feature or features, you specify the features to
remove. Then the upgrade removes only the features you specify and leaves
any other features. The list of features should be comma-delimited. The feature
names must exactly match those in the previous version.
Example: Suppose Application 1.0 contains Feature1, Feature2, and Feature3.
Application 2.0 contains Feature1, Feature2, and Feature4; Feature3 has been
dropped. When you upgrade 1.0 users, you enter Feature1, Feature2 in
Features to remove. When the upgrade occurs, Windows Installer first
removes Feature1 and Feature2 from the existing installation, then installs
Feature1, Feature2, and Feature4. Therefore, users of 1.0 still have Feature3.
Action Property
Specify a property to run a particular custom action based on which product
version is already installed. During installation, if an application with the same
upgrade code is found on the destination computer, its product code is placed
into this property. You can set conditions on custom actions so that they
execute based on the contents of this property. If you choose to create a new
property, enter its name in all uppercase letters, and add it to the list of
restricted public properties, which is stored in the SecureCustomProperties
property. Only restricted public properties appear in this list.
Continue installation after a remove failure
Mark this to continue the installation, even if it is unable to remove one or more
features of the installed application.
Migrate feature states
Mark this to retain the feature states of the installed application during the
upgrade. Example: If the end user chose not to install a feature, such as a spell
checker, in the initial installation, the upgrade will not install it either.
Do not uninstall previous version
Mark this to keep the previous version of the application on the destination
computer when the upgrade is installed. This lets the end user have two
versions of the application installed.
4. Click OK.
