The File: URL Scheme

The File: URL Scheme

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

When constructing a URL using the file: URL scheme for use with the Exchange OLE DB (ExOLEDB) provider, each URL has the following two forms. You use the first form to access a user's base mailbox folder. You use the second form to access items in public folder trees.

file://./backofficestorage/domain-name/MBX/user-alias/path
file://./backofficestorage/domain-name/public-folder-tree-name/path
		

domain-name

The fully qualified name of the domain that the user account is a part of, for example, "subdomain.example.com". Note that this domain name does not include the name of the server itself.

public-folder-tree-name

For private mailboxes, this is always "MBX". For items stored in a public store, this is the name of the public folder tree in which the item resides. Note that this is not the name of the public store that houses the public folder tree.

The following table lists the default names provided by Microsoft® Exchange Server 2003 to access private mailboxes and the default public folder tree.

Default folder tree name Description
MBX Contains all private mailboxes.
Public Folders Contains the default public store installed with Exchange Server 2003.

When you add new public stores and associated public folder trees, you use the name of that public folder tree in the URL. To access mailboxes in additional private stores, you always use "MBX".

user-alias

The user's Exchange mailbox alias, for example, User1.

path

The folder path to the item. This path consists of a series of folder names separated by "/" characters.

The ExOLEDB provider registers the File: OLE DB URL namespace with the OLE DB root binder. Therefore, you need not specify this provider explicitly when you use OLE DB, Microsoft ActiveX® Data Objects (ADO), or Collaboration Data Objects (CDO) objects to access items by using the File: URL scheme.

The URLs in the following examples use the File: scheme:

file://./backofficestorage/sample.example.com/public folders/reports/report1.doc
file://./backofficestorage/sample.example.com/public folders/reports/schema/

file://./backofficestorage/sample.example.com/MBX/User1/Inbox
file://./backofficestorage/sample.example.com/MBX/User1/Calendar
file://./backofficestorage/sample.example.com/MBX/User1/Drafts

file://./backofficestorage/sample.example.com/application1/app1/
file://./backofficestorage/sample.example.com/application1/app1/schema

The URLs in the following examples point to a user's mailbox folders (English).

Folder URL
Calendar file://./backofficestorage/example.com/MBX/UserAlias/Calendar
Contacts file://./backofficestorage/example.com/MBX/UserAlias/Contacts
Drafts file://./backofficestorage/example.com/MBX/UserAlias/Drafts
Inbox file://./backofficestorage/example.com/MBX/UserAlias/Inbox
Journal file://./backofficestorage/example.com/MBX/UserAlias/Journal
Notes file://./backofficestorage/example.com/MBX/UserAlias/Notes
Outbox file://./backofficestorage/example.com/MBX/UserAlias/Outbox
Sent Items file://./backofficestorage/example.com/MBX/UserAlias/Sent%20Items
Tasks file://./backofficestorage/example.com/MBX/USerAlias/Tasks

 

Note  The URLs in the preceding table are only examples; you should not construct them manually in your application. You can retrieve all of the URLs in a user's localized mailbox folder by using the IMailBox Interface on a Person object or by retrieving properties on the base mailbox folder, such as inbox Field or calendar Field.

Send us your feedback about the Microsoft Exchange Server 2003 SDK.

Build: June 2007 (2007.618.1)

© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.