This function is used to copy a source file from a source folder to a target folder expanding the file if its compressed. It will in addition copy any language resource files associated with the file.
Require_File,SourceFile,[SourceFolder],[TargetFolder],[PRESERVE]|[OverWrite],[NOWARN],[MUISource]
1 | SourceFile | Name of the file to copy. For XP based projects this should be the final expanded file name not the compressed file name. This may optionally contain a path which will be relative to the SourceFolder / TargetFolder parameters. |
2 | SourceFolder | Folder containing the file to copy. This defaults to %Source_Sys%. |
3 | TargetFolder | Folder to which the file is to be copied. This defaults to %Target_Sys%. |
4 | PRESERVE | By default if the target file exists it will be overwritten - this can be explicitly requested by . This parameter is used to not copy the file if it already exists in the target folder. A warning will be generated in the log file if the target file exists. The optional NOWARN parameter can be used to suppress this warning. |
5 | NOWARN | By default a warning will be generated in the log file if the target file exists. This parameter is used to suppress the warning. |
6 | MUISource | For XP based projects only this parameter optionally allows the folder containing the language specific files associated with the source file to be specified. |
This always copies shlwapi.dll, only copies swenum.sys if it does not exist in the target directory but logs a warning, only copies swenum.sys if it does not exist in the target directory and supresses the warning if it already exists in the target directory.
Require_File,shlwapi.dll Require_File,shlwapi.dll,,,PRESERVE Require_File,shlwapi.dll,,,PRESERVE,NOWARN
This always copies swenum.sys from the %Source_Sys%\drivers folder to the %target_sys%\drivers folder
Require_File,drivers\swenum.sys