FeatureMoveData

InstallShield 2013 ยป InstallScript Language Reference

Project: This information applies to InstallScript projects:

The FeatureMoveData function transfers and decompresses files associated with selected features in the file media referenced by szFeatureSource. The function automatically prompts the end user for the next disk when it is needed.

If you use this function to transfer files to WINSYSDIR64, you must first disable file system redirection using WOW64FSREDIRECTION. Otherwise, files being transferred to WINSYSDIR64 are incorrectly redirected to the 32-bit SysWOW64 folder. Since some Windows functionality that could be used by the installation requires that redirection be enabled to work, Windows documentation recommends that you disable redirection only for as long as necessary. It is recommended that you then enable file system redirection as soon as you have completed transferring the necessary files to WINSYSDIR64. To learn more, see Targeting 64-Bit Operating Systems with InstallScript Installations.

When you call FeatureMoveData, Do (SELFREGISTRATIONPROCESS) is called automatically after the files are installed but before the call returns. Therefore, if your installation needs to perform additional actions after the file transfer but before self-registration, place these actions in the OnMoved event; the OnMoved event is called after the file transfer but before the batch self-registration occurs.

You can call FeatureMoveData more than once on the same media, but you must reset internal structures before the second and subsequent calls by calling FeatureMoveData with a null string ("") in the first parameter position. InstallShield automatically initializes the default media and internal structures before your first call to FeatureMoveData.

Note: This function cannot be used with script-created feature sets.

Syntax

FeatureMoveData ( szFeatureSource, nvReserved, nReserved );

Parameters

FeatureMoveData Parameters

Parameter

Description

szFeatureSource

Specifies the media name of the file media whose files are to be transferred.

nvReserved

Pass a number variable in this argument. No useful data is returned.

nReserved

Pass zero in this parameter. No other value is allowed.

Return Values

FeatureMoveData Return Values

Return Value

Description

0

FeatureMoveData was successful.

< 0

FeatureMoveData failed. Call FeatureError for additional information.

See Also