Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |