FeaturePatch

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to InstallScript projects.

The FeaturePatch function is called only in installations that use differential media. (You can check the media format by calling MediaGetData with MEDIA_FIELD_MEDIA_FLAGS as its second argument).

FeaturePatch causes the next call to FeatureTransferData or FeatureMoveData to reinstall all features that are already installed when FeatureTransferData is called, including all of the maintenance/uninstallation feature’s files except for Data1.hdr, Data1.cab, and Layout.bin. (Note that the maintenance/uninstallation feature is automatically placed in your disk image by the release builder and is not displayed in InstallShield.) A copy of the running file media library is stored on the target machine for use during subsequent maintenance operations, that is, modifying, repairing, or uninstalling.

Syntax

FeaturePatch ( );

Parameters

None.

Return Values

FeaturePatch Return Values

Return Value

Description

0

Indicates that the function succeeded.

< 0

Indicates that the function failed.

Additional Information

FeaturePatch is called in the default code for the OnUpdateUIBefore event handler function.

See Also