Folder Object

 

Folder Object

The Folder object represents a folder or container within the MAPI system. A folder can contain subfolders and messages.

At a Glance

Specified in type library:	CDO.DLL
First available in:	CDO Library version 1.0.a
Parent objects:	Folders collection InfoStoreSession
Child objects:	Fields collection Folders collection Messages collection
Default property:	(none)

Properties

Name	Available since version	Type	Access
Application	1.0.a	String	Read-only
Class	1.0.a	Long	Read-only
Fields	1.0.a	Field object or Fields collection object	Read-only
FolderID	1.0.a	String	Read-only
Folders	1.0.a	Folders collection object	Read-only
HiddenMessages	1.2	Messages collection object	Read-only
ID	1.0.a	String	Read-only
MAPIOBJECT	1.0.a	IUnknown object	Read/write (Note: Not available to Visual Basic applications)
Messages	1.0.a	Messages collection object	Read-only
Name	1.0.a	String	Read/write
Parent	1.0.a	Folders collection object or InfoStore object	Read-only
Session	1.0.a	Session object	Read-only
StoreID	1.0.a	String	Read-only

Methods

Name	Available since version	Parameters
CopyTo	1.1	folderID as String, (optional) storeID as String, (optional) name as String, (optional) copySubfolders as Boolean
Delete	1.0.a	(none)
IsSameAs	1.1	objFolder2 as Object
MoveTo	1.1	folderID as String, (optional) storeID as String
Update	1.0.a	(optional) makePermanent as Boolean, (optional) refreshObject as Boolean

Remarks

A Folder object can be rendered into HTML hypertext using the CDO Rendering ObjectRenderer object. To specify this, set the object renderer's DataSource property to the Folder object itself. The individual properties that can be rendered with the RenderProperty method are indicated in the Folder object property descriptions.

A Folder object can also be rendered as the parent of a Messages collection, using the ContainerRenderer object. The individual properties that can be rendered with the RenderProperty method are indicated in the Folder object property descriptions.

Changes to a folder are not saved by MAPI until you call its Update method.