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 |
https://schemas.microsoft.com/exchange/services/2006/types |
| Schema Name |
Types schema |
| Validation File |
Types.xsd |
| Can be Empty |
False |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for