DistinguishedFolderId

Topic Last Modified: 2007-10-30

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

Syntax

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

Type

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.

Child Elements

Element Description

Mailbox

Identifies a primary SMTP address. Proxy addresses are not allowed. The use of this element is optional based on the use of the DistinguishedFolderId element. The Mailbox element is required for delegate access.

Parent Elements

Element Description

ParentFolderId (Create)

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 and FindFolder operations.

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.

Remarks

A DistinguishedFolderId resolves to a FolderId.

The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Element Information

Namespace

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

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False