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 |
|---|---|
Identifies a primary SMTP address. Proxy addresses are not allowed. |
Parent Elements
Element |
Description |
|---|---|
Indicates the folder that is targeted for conversation actions that use folders. |
|
Indicates the destination folder for copy and move conversation actions. |
|
Identifies the folder in which a new folder or item is created. The following are the XPath expressions to this element:
|
|
Identifies folders to search for the FindItem Operation and the FindFolder Operation. |
|
Represents the collection of folders that will be searched to determine the contents of a search folder. |
|
Contains an array of folder identifiers that are used to identify folders to copy, move, get, delete, or monitor for event notifications. |
|
Represents a collection of changes to be performed on a single folder. The following is the XPath expression to this element: /UpdateFolder/FolderChanges/FolderChange |
|
Represents the destination folder for a copied or moved item or folder. The following are the XPath expressions to this element:
|
|
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:
|
|
Represents the folder that contains the items to synchronize. |
|
Represents the name of a user configuration object. The user configuration object name is the identifier for a user configuration object. |
|
Represents the ID of the folder that e-mail items will be copied to. |
|
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 |
See Also