Platform SDK: CDO 1.2.1

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