The InfoStore object provides access to the folder hierarchy of a message store.
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 |
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 |
Name |
Available since version | Parameters |
---|---|---|
IsSameAs | 1.1 | objInfoStore2 as Object |
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.
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 ...