VB & VBA in a Nutshell: The Language

Folder.Move Method (VB6)

Named Arguments

Yes

Syntax

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.

Description

Moves a folder structure from one location to another.

Rules at a Glance

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

Programming Tips and Gotchas

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