FeatureSelectNew

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to InstallScript projects.

The FeatureSelectNew function sets the selection status of all new features to either selected or unselected.

Syntax

FeatureSelectNew (szFeatureSource, bSelect);

Parameters

FeatureSelectNew Parameters

Parameter

Description

szFeatureSource

Specifies the media name of the file media library containing the new features whose selection status is to be set. Typically, this argument is set equal to the system variable MEDIA.

bSelected

Specifies whether the new features are selected or deselected. Pass one of the following predefined constants in this parameter:

•

TRUE—Selects the new features.

•

FALSE—Deselects the new features.

Return Values

FeatureSelectNew Return Values
Parameter	Description
0	FeatureSelectNew successfully set the new features' selection status.
< 0	FeatureSelectNew was unable to set the new features' selection status. You can obtain the error message text associated with a large negative return value—for example, -2147024891 (0x80070005)—by calling FormatMessage.

Additional Information

New features are features that exist in the installation's file media library but not in the existing log file. FeatureSelectNew is typically called in an update installation to select new features before displaying features in features dialogs. FeatureSelectNew is called in the default code for the OnUpdateUIBefore event handler function.

Note: If you call a setup type selection function after calling FeatureSelectNew, the feature selections set by FeatureSelectNew are overridden by the selections in the setup type.

It is usually unnecessary to call FeatureSelectNew during maintenance mode because the previous feature selections are automatically loaded from the existing log file.

FeatureSelectNew

InstallShield 2014 Help Library

May 2014