You also can't use this command to rename files across drives or to move files to a different directory.Ĭharacters represented by wildcard characters in filename2 will be identical to the corresponding characters in filename1.įilename2 must be a unique file name. You can't specify a new drive or path when renaming files. You can use wildcard characters to specify new names for multiple files. Filename1 can include wildcard characters ( * and ?). Specifies the location and name of the file or set of files you want to rename. Indicates that the function was unable to change the name of the file or folder or move the file or folder.This command is the same as the ren command. Indicates that the function successfully changed the name of the file or directory or moved the file or directory. If szFileNew contains an unqualified file name or directory name (without path information), RenameFile either renames the file or directory, or moves the file or directory to the directory specified by the system variable TARGETDIR (for an InstallScript installation) or the system variable INSTALLDIR (for a Basic MSI or InstallScript MSI installation).

If szFileNew specifies a fully qualified file name or directory (it includes a path), RenameFile renames the file or moves it to the specified directory. Specifies a new name and/or location for the file or directory. Only one file or one directory (including its subdirectories and folders) can be renamed or moved with each call to RenameFile. Note: Wildcard characters are not permitted. If szSource contains an unqualified file name or directory name (without path information), RenameFile renames or moves the file or directory in the directory specified by the system variable SRCDIR. If szFileOld specifies a fully qualified file name or directory (it includes a path), RenameFile renames or moves the file or directory in the specified directory. Specifies the name of the file or directory to be renamed or moved. If szSource and szTarget reference different directories or-when using unqualified names, if SRCDIR and TARGETDIR reference different directories for an InstallScript installation (or if SRCDIR and INSTALLDIR reference different directory for a Basic MSI or InstallScript MSI installation)-the file or directory that is specified by szSource is moved to the new directory and given the name that is specified by szTarget, unless a file or directory with that name already exists in that directory. If szSource and szTarget reference the same directory or-when using unqualified names, if SRCDIR and TARGETDIR reference the same directory for an InstallScript installation (or if SRCDIR and INSTALLDIR reference the same directory for a Basic MSI or InstallScript MSI installation)-the file or directory that is specified by szSource is renamed, unless a file or directory with the name that is specified by szTarget already exists in that directory. The RenameFile function changes the name of a file or directory and/or moves a file or directory (and its subdirectories and files) from one parent directory to another. InstallShield 2014 » InstallScript Language Reference

Renamefiles