FeatureRemoveAllInLogOnly

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to InstallScript projects.

The FeatureRemoveAllInLogOnly function is called during an update installation to force the removal of all features that are not in the current media but were installed previously, as recorded in the setup log file.

Syntax

FeatureRemoveAllInLogOnly ( );

Parameters

None.

Return Values

FeatureRemoveAllInLogOnly Return Values

Return Value

Description

0

Indicates that the function successfully deselected the feature selections.

< 0

Indicates that the function was unable to deselect the feature selections.

You can obtain the error message text associated with a large negative return value—for example, -2147024891 (0x80070005)—by calling FormatMessage.

Additional Information

Calling FeatureRemoveAllInLogOnly causes all features that are not in the current media but were installed previously to be deselected. As a result, when FeatureTransferData is called, those features will be removed (uninstalled).

Caution: Do not call FeatureRemoveAllInLogOnly in an "add-on" installation—that is, an installation with the same INSTANCE_GUID as a application already on the system that includes a subset of the features in the earlier installation. The result would be the uninstallation (removal) of all features that were contained in the earlier installation, but not the features in the current installation.

If no valid log file is found during installation initialization, calling FeatureRemoveAllInLogOnly has no effect.

See Also