FileSystemObject.MoveFolder Method (VB6)

---

Named Arguments

Yes

Syntax

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.

Description

Moves a folder along with its files and subfolders from one location to another.

Rules at a Glance

• 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.

Programming Tips and Gotchas

• 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"

  
  

See Also

FileSystemObject.CopyFolder Method, FileSystemObject.FolderExists Method, FileSystemObject.GetAbsolutePath Method, Folder.Move Method