Add Method (Folders Collection)
Add Method (Folders Collection)
The Add method creates and returns a new Folder object in the Folders collection.
Syntax
Set objFolder = objFoldersColl.Add(name)
objFolder
On successful return, contains the new Folder object.
objFoldersColl
Required. The Folders collection object.
name
Required. String. The display name of the folder.
Remarks
The name parameter corresponds to the Name property of the Folder object.
The user must have permission to Add or Delete a Folder object. Most users have this permission only for their personal folders.
You do not need to call the Update method of the new Folder object when you Add it to the collection. However, when you set or change any of the folder's properties, you must call Update to save the changes in the MAPI system.
Example
This code fragment adds a new folder to a user's Inbox:
Dim myInbox As Folder
Dim newFolder As Folder
Dim objSess As MAPI.Session ' use early binding for efficiency
Set objSess = CreateObject ("MAPI.Session")
Set myInbox = objSess.Inbox
' add new folder to Inbox
Set newFolder = myInbox.Folders.Add "Personal Messages"
' Update not needed until changes made