• Article

DistinguishedFolderId

Last modified: September 21, 2010

Applies to: Exchange Server 2007 | Exchange Server 2010

The DistinguishedFolderId element identifies folders that can be referenced by name. If you do not use this element, you must use the FolderId element to identify a folder.

<DistinguishedFolderId Id="" ChangeKey="">
   <Mailbox/>
</DistinguishedFolderId>

DistinguishedFolderIdType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

Id

Contains a string that identifies a default folder. This attribute is required.

ChangeKey

Contains a string that identifies a version of a folder that is identified by the Id attribute. This attribute is optional. Use this attribute to make sure that the correct version of a folder is used.

Id Attribute Values

Value

Description

calendar

Represents the Calendar folder.

contacts

Represents the Contacts folder.

deleteditems

Represents the Deleted Items folder.

drafts

Represents the Drafts folder.

inbox

Represents the Inbox folder.

journal

Represents the Journal folder.

notes

Represents the Notes folder.

outbox

Represents the Outbox folder.

sentitems

Represents the Sent Items folder.

tasks

Represents the Tasks folder.

msgfolderroot

Represents the message folder root.

root

Represents the root of the mailbox.

junkemail

Represents the Junk E-mail folder.

searchfolders

Represents the Search Folders folder.

voicemail

Represents the Voice Mail folder.

recoverableitemsroot

Represents the dumpster root folder.

recoverableitemsdeletions

Represents the dumpster deletions folder.

recoverableitemsversions

Represents the dumpster versions folder.

recoverableitemspurges

Represents the dumpster purges folder.

archiveroot

Represents the root archive folder.

archivemsgfolderroot

Represents the root archive message folder.

archivedeleteditems

Represents the archive deleted items folder.

archiverecoverableitemsroot

Represents the archive recoverable items root folder.

Archiverecoverableitemsdeletions

Represents the archive recoverable items deletions folder.

Archiverecoverableitemsversions

Represents the archive recoverable items versions folder.

Archiverecoverableitemspurges

Represents the archive recoverable items purges folder.

Child Elements

Element

Description

Mailbox

Identifies a primary SMTP address. Proxy addresses are not allowed.

Parent Elements

Element

Description

ContextFolderId

Indicates the folder that is targeted for conversation actions that use folders.

DestinationFolderId

Indicates the destination folder for copy and move conversation actions.

ParentFolderId (TargetFolderIdType)

Identifies the folder in which a new folder or item is created.

The following are the XPath expressions to this element:

  • /CreateItem/ParentFolderId

  • /CreateFolder/ParentFolderId

ParentFolderIds

Identifies folders to search for the FindItem Operation and the FindFolder Operation.

BaseFolderIds

Represents the collection of folders that will be searched to determine the contents of a search folder.

FolderIds

Contains an array of folder identifiers that are used to identify folders to copy, move, get, delete, or monitor for event notifications.

FolderChange

Represents a collection of changes to be performed on a single folder.

The following is the XPath expression to this element: /UpdateFolder/FolderChanges/FolderChange

ToFolderId

Represents the destination folder for a copied or moved item or folder.

The following are the XPath expressions to this element:

  • /MoveFolder/ToFolderId

  • /CopyFolder/ToFolderId

  • /MoveItem/ToFolderId

  • /CopyItem/ToFolderId

SavedItemFolderId

Identifies the target folder for operations that update, send, and create items in the Exchange store.

The following are the XPath expressions to this element:

  • /CreateItem/SavedItemFolderId

  • /UpdateItem/SavedItemFolderId

  • /SendItem/SavedItemFolderId

SyncFolderId

Represents the folder that contains the items to synchronize.

UserConfigurationName

Represents the name of a user configuration object. The user configuration object name is the identifier for a user configuration object.

CopyToFolder

Represents the ID of the folder that e-mail items will be copied to.

MoveToFolder

Represents the ID of the folder that e-mail items will be moved to.

Text Value

None.

Remarks

A DistinguishedFolderId resolves to a FolderId.

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services of the Client Access server.

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/types

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False