FileSystemObject.MoveFolder Method (VB6) |
Yes
oFileSysObj.MoveFolder source , destination
oFileSysObj
Use: Required
Data Type: FileSystemObject object
Any object variable returning a FileSystemObject object.
source
Use: Required
Data Type: String
The path to the folder or folders to be moved.
destination
Use: Required
Data Type: String
The path to the location where the folder or folders are to be moved.
Moves a folder along with its files and subfolders from one location to another.
source must end with either a wildcard character or no path separator.
Wildcard characters can be used in source, but only for the last component.
Wildcard characters can't be used in destination.
All subfolders and files contained within the source folder are copied to destination unless disallowed by the wildcard characters. That is to say, the MoveFolder method is recursive.
If destination ends with a path separator or Source ends with a wildcard, MoveFolder assumes that the folder in Source exists in Destination. For example, given the following folder structure:
C: Rootone SubFolder1 SubFolder2 RootTwo
MoveFolder "c:Rootone*", "C:RootTwo" produces this folder structure:
C: Rootone RootTwo SubFolder1 SubFolder2
MoveFolder "c:Rootone", "C:RootTwo" produces this folder structure:
C: RootTwo Rootone SubFolder1 SubFolder2
source and destination can be either absolute or relative paths.
source and destination can be network paths or share names.
The MoveFolder method resolves both arguments before beginning the operation.
If a fatal system error occurs during the execution of this method (like a power failure), the worst that can happen is that the file is copied to the destination but not removed from the source. There are no rollback capabilities built into the FileSystemObject.MoveFolder method, however, since, because the copy part of this two-stage process is executed first, the file can't be lost.
Although there is no chance of actually losing data, it can be difficult to determine whether the operation has succeeded or failed in the event of an error when multiple folders are being moved. This is because an error in the middle of a multifile move operation causes the MoveFolder method to be abandoned and subsequent folder operations to be aborted.
You can call the GetAbsolutePath and FolderExists methods before calling the MoveFile method to ensure its success.
If the user has adequate rights, the source or destination can be a network path or share name. For example:
MoveFolder "c:Rootone", "\NTSERV1d$RootTwo"