RequireSysFile (Vista / Win7 Projects only )
Copy a source file from the %SystemFiles% source folder to the %TargetDir% target folder.
Syntax
RequireSysFile,SourceFile,[NOWARN],[PRESERVE]
Parameters
| 1 | SourceFile | Name of the file to copy. This may optionally contain a path which will be relative to the %SystemFiles% / %TargetDir% folders. |
| 2 | 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. |
| 3 | PRESERVE | By default if the target file exists it will be overwritten. 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. |
Remarks
- The copy will always be from the mounted install.wim.
- It will in addition copy any language resource files associated with the file.
Tips
The NOWARN and PRESERVE parameters can be specified in any order.
NOTE:
This functon has been superceded by the Require_File function which works for all common API projects.
Example
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.
RequireSysFile,windows\system32\shlwapi.dll RequireSysFile,windows\system32\shlwapi.dll,PRESERVE RequireSysFile,windows\system32\shlwapi.dll,NOWARN,PRESERVE
This always copies swenum.sys from the %Source_Sys%\drivers folder to the %target_sys%\drivers folder
Require_File,windows\system32\drivers\swenum.sys