DistinguishedFolderId

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 Email 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.
archiveinbox
Represents the archive Inbox folder. Versions of Exchange starting with build number 15.00.0913.09 include this value.
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.
syncissues
Represents the sync issues folder.
conflicts
Represents the conflicts folder.
localfailures
Represents the local failures folder.
serverfailures
Represents the server failures folder.
recipientcache
Represents the recipient cache folder.
quickcontacts
Represents the quick contacts folder.
conversationhistory
Represents the conversation history folder.
adminauditlogs
Represents the admin audit logs folder.
todosearch
Represents the todo search folder.
mycontacts
Represents the My Contacts folder.
directory
Represents the directory folder.
imcontactlist
Represents the IM contact list folder.
peopleconnect
Represents the people connect folder.
favorites
Represents the Favorites 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 email items will be copied to.
MoveToFolder
Represents the ID of the folder that email 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.

Element information

Element Example
Namespace
http://schemas.microsoft.com/exchange/services/2006/types
Schema Name
Types schema
Validation File
Types.xsd
Can be Empty
False

See also