InfoStore Object

 

InfoStore Object

The InfoStore object provides access to the folder hierarchy of a message store.

At a Glance

Specified in type library:	CDO.DLL
First available in:	CDO Library version 1.0.a
Parent objects:	Fields collection InfoStores collection
Child objects:	Folder
Default property:	Name

Properties

Name	Available since version	Type	Access
Application	1.0.a	String	Read-only
Class	1.0.a	Long	Read-only
Fields	1.1	Field object or Fields collection object	Read-only
ID	1.0.a	String	Read-only
Index	1.0.a	Long	Read-only
MAPIOBJECT	1.1	IUnknown object	Read/write (Note: Not available to Visual Basic applications)
Name	1.0.a	String	Read-only
Parent	1.0.a	InfoStores collection object	Read-only
ProviderName	1.0.a	String	Read-only
RootFolder	1.0.a	Folder object	Read-only
Session	1.0.a	Session object	Read-only

Methods

Name	Available since version	Parameters
IsSameAs	1.1	objInfoStore2 as Object

Remarks

The InfoStore object provides access to its interpersonal message folder hierarchy through the RootFolder property, which returns the Folder object that represents the root of the IPM subtree. To access the root folder of the entire message store, first obtain its identifier with the FolderID property of the IPM root folder, and then call the Session object’s GetFolder method.

You can obtain any InfoStore object available to this session with the Item property of the InfoStores collection. You can also retrieve an InfoStore object with a known identifier by calling the session’s GetInfoStore method.

Example

Dim objInfoStore, objIPMRoot, objStoreRoot as Object
Dim rootID as String
Set objInfoStore = objSession.InfoStores.Item(1)
If objInfoStore is Nothing Then
    MsgBox "Cannot open session's first message store"
    ' Exit ...
End If
Set objIPMRoot = objInfoStore.RootFolder
rootID = objIPMRoot.FolderID
Set objStoreRoot = objSession.GetInfoStore (rootID)
' ... error checking ...