InfoStores Property (Session Object)
InfoStores Property (Session Object)
The InfoStores property returns a single InfoStore object or an InfoStores collection available to this session. Read-only.
Syntax
Set objInfoStoresColl = objSession.InfoStores
Set *objOneInfoStore = objSession.*InfoStores(index)
Set *objOneInfoStore = objSession.*InfoStores(name)
objInfoStoresColl
Object. An InfoStores collection object.
objSession
Object. The Session object.
objOneInfoStore
Object. A single InfoStore object.
index
Long. Specifies the number of the message store within the InfoStores collection. Ranges from 1 to the value specified by the InfoStores collections Count property.
name
String. The value of the Name property of the InfoStore object to be selected.
Data Type
Object (InfoStore or InfoStores collection)
Remarks
The InfoStores property returns a specific message store or a collection of available message stores. Each InfoStore object in the collection represents an individual message store and provides access to its folder hierarchy.
You can access public folders through the InfoStores collection. The public folders are maintained in their own InfoStore object, which is distinct from the message store containing the users personal messages. The public folders store typically has "Public Folders" in its Name property and is always positioned first in the collection, so that its Index property always has the value 1.
If your application is running as a Microsoft® Windows NT® service, you cannot access the Microsoft Exchange Public Folders through the normal hierarchy because of a notification conflict. You must use the InfoStore objects Fields property to obtain the Microsoft Exchange property PR_IPM_PUBLIC_FOLDERS_ENTRYID, property tag &H66310102. This represents the top-level public folder and allows you to access all other public folders through its Folders property.
When you know the unique identifier for a particular InfoStore object, you can obtain it directly with the Session objects GetInfoStore method.
Although the InfoStores property itself is read-only, the collection it returns can be accessed in the normal manner, and the properties on its member InfoStore objects retain their respective read/write or read-only accessibility.
Example
' from the functions Session_InfoStores and InfoStores_FirstItem
Dim objSession as MAPI.Session
Dim objInfoStoresColl as InfoStores
Dim objInfoStore as InfoStore
' assume valid Session object
Set objInfoStoresColl = objSession.InfoStores
If objInfoStoresColl Is Nothing Then
MsgBox "Could not set InfoStores collection"
Exit Function
End If
If 0 = objInfoStoresColl.Count Then
MsgBox "No InfoStores in the collection"
Exit Function
End If
collIndex = 1
Set objInfoStore = objInfoStoresColl.Item(collIndex)
' could be objInfoStoresColl(collIndex) since Item is default property
If objInfoStore Is Nothing Then
MsgBox "Cannot get first InfoStore object"
Exit Function
Else
MsgBox "Selected InfoStores item " & collIndex
End If
If "" = objInfoStore.Name Then
MsgBox "Active InfoStore has no name; ID = " & objInfoStore.Id
Else
MsgBox "Active InfoStore has name: " & objInfoStore.Name
End If