FeatureUpdate

InstallShield 2014 ยป InstallScript Language Reference

Project: This information applies to InstallScript project.

The FeatureUpdate function causes the next call to FeatureTransferData (or FeatureMoveData) to reinstall all features that are already installed when FeatureTransferData is called, except the maintenance/uninstallation feature. (Note that this feature is automatically placed in your .cab files by the media builder and is not displayed in InstallShield.)

Syntax

FeatureUpdate ( szReserved );

Parameters

FeatureUpdate Parameters

Parameter

Description

szReserved

Pass a null string ("") in this parameter. No other value is allowed.

Return Values

FeatureUpdate Return Values

Return Value

Description

0

Indicates that the function succeeded.

< 0

Indicates that the function failed.

Additional Information

Call FeatureUpdate in an installation whose maintenance/uninstallation feature you do not want to be used during subsequent maintenance operations (modifying, repairing, or uninstalling). FeatureUpdate is typically called in an update or add-on installation, in which the installation media does not contain all the elements of the previous media and thus should not be used for subsequent maintenance operations.

FeatureUpdate is similar to FeatureReinstall, but FeatureReinstall also reinstalls the maintenance/uninstallation feature.

Note: If you call both FeatureUpdate and FeatureReinstall, the call to FeatureUpdate will not have any effect; so if you call FeatureUpdate, do not call FeatureReinstall in the same installation.

Call FeatureUpdate to update only applications that were installed with the same version of InstallShield as the update installation. If you call FeatureUpdate to update an application that was installed with a previous version of InstallShield, the maintenance/uninstallation files will not be updated, so any subsequent maintenance operations will use the maintenance/uninstallation files that were created with the previous version.

The following information applies in this situation: A previously released version of your application was installed by an installation that aborts if a newer version of the application is present. In this case, FeatureUpdate should not be called in an update installation that changes the version number of the installed application. Otherwise, after the update installation runs, the currently installed application cannot be uninstalled.

See Also