Share via


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