Store Object

Represents a file on the local computer or a network drive that stores e-mail messages and other items for an account in the current profile.

Version Information
 Version Added:  Outlook 2007

Remarks

A profile defines one or more e-mail accounts, and each e-mail account is associated with a server of a specific type. For an Exchange server, a store can be on the server, in an Exchange Public folder, or in a local Personal Folders File (.pst) or Offline Folder File (.ost). For a POP3, IMAP, or HTTP e-mail server, a store is a .pst file.

You can use the Stores and Store objects to enumerate all folders and search folders on all stores in the current session. Since getting the root folder or search folders in a store requires the store to be open and opening a store imposes an overhead on performance, you can check the Store.IsOpen property before you decide to pursue the operation.

If you use an Exchange server, you can access other explicit built-in Store properties for store characteristics such as ExchangeStoreType, IsCachedExchange, and IsDataFileStore. Use the PropertyAccessor object returned by Store.PropertyAccessor to access other store properties that are not exposed in the Outlook object model.

For more information on storing Outlook items in folders and stores, see Storing Outlook Items.

Example
The following code sample in Microsoft Visual Basic for Applications (VBA) enumerates all folders on all stores for a session:

  Sub EnumerateFoldersInStores()
    Dim colStores As Outlook.Stores
    Dim oStore As Outlook.Store
    Dim oRoot As Outlook.Folder
    
    On Error Resume Next
    Set colStores = Application.Session.Stores
    For Each oStore In colStores
        Set oRoot = oStore.GetRootFolder
        Debug.Print (oRoot.FolderPath)
        EnumerateFolders oRoot
    Next
End Sub
Private Sub EnumerateFolders(ByVal oFolder As Outlook.Folder)
Dim folders As Outlook.folders
Dim Folder As Outlook.Folder
Dim foldercount As Integer
On Error Resume Next
Set folders = oFolder.folders
foldercount = folders.Count
'Check if there are any folders below oFolder
If foldercount Then
    For Each Folder In folders
        Debug.Print (Folder.FolderPath)
        EnumerateFolders Folder
    Next
End If

End Sub

See Also

• Outlook Object Model Reference
• Store Object Members
• How to: Enumerate Folders on All Stores
• How to: Enumerate Search Folders on All Stores