InstallShield 2019 » 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
|
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:
|
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.
See Also
InstallShield 2019 Help LibraryApril 2019 |
Copyright Information | Flexera |