Folder.Move Method (VB6) |
Yes
oFolderObj.Move destination
oFolderObj
Use: Required
Data Type: Folder object
Any object variable returning a Folder object.
destination
Use: Required
Data Type: String
The path to the location where the folder or folders are to be moved.
Moves a folder structure from one location to another.
Wildcard characters can't be used in Destination.
If any of the files within the folder being moved are open, an error is generated.
All subfolders and files contained within the source folder are copied to Destination, unless disallowed by the wildcard characters. That is to say, the Move method is recursive.
Destination can be either an absolute or a relative path.
If a fatal system error occurs during the execution of this method (like a power failure), the worst that can happen is that the folder is copied to the destination but not removed from the source. There are no roll-back capabilities built into the Folder.Move method, however, since, because the copy part of this two-stage process is executed first, the folder can't be lost.
If an error occurs in the middle of a move operation, the operation is terminated immediately, and the remaining files and folders in the folder aren't moved.
To ensure its success, you can use the FileSystemObject's FolderExists and GetAbsolutePath methods prior to calling the Move method.
Unlike the FileSystemObject's MoveFolder method, which accepts wildcard characters in the source parameter and can therefore move multiple folders, the Move method moves only the single folder represented by the Folder object and its contents.
Immediately after the Move method executes, the Folders collection object containing the Folder object is automatically updated, the moved folder is removed from the collection and the collection count is reduced by one. You shouldn't try to access the moved folder object again from the same Folders collection object.
If the user has adequate rights, the destination can be a network path or share name. For example:
Move "\NTSERV1d$RootTwo"