[This is preliminary documentation and subject to change.]
The DuplicateFiles action allows the author to make one or more duplicate copies of files installed by the InstallFiles action. The duplicate files can be copied to the same directory with a different name, or to a different directory with the original name.
| DuplicateFile.FileKey | Primary key, uniquely identifying an entry in the MoveFile table. |
| DuplicateFile.Component_ | Foreign key into the Component table. |
| DuplicateFile.File_ | Foreign key into the File table, representing the original file to be duplicated. |
| DuplicateFile.DestName | Name to be given to the destination file. |
| DuplicateFile.DestFolder | Property name whose value identifies the destination folder. |
None
The DuplicateFiles action must occur after the InstallFiles action.
The DuplicateFiles action processes a DuplicateFile table entry only if the component linked to that entry is being installed locally.
The string in the DestFolder field is a property name whose value is expected to resolve to a fully qualified path. This property could be any of the directory entries in the Directory table, any pre-defined folder property (CommonFilesFolder, for example), or a property set by any entry in the AppSearch table.
For a particular entry in the DuplicateFile table, if the DestFolder property does not evaluate to a valid path, DuplicateFiles does nothing for that entry.
The name to be given to the destination file can be specified in the DestName field. If this field is left blank, the destination file name is the same as the original file name.
Files installed by the DuplicateFiles action are uninstalled when appropriate by the RemoveDuplicateFiles action.