DistinguishedFolderIdDistinguishedFolderId

DistinguishedFolderId元素标识可通过名称引用的文件夹。The DistinguishedFolderId element identifies folders that can be referenced by name. 如果不使用此元素,则必须使用FolderId元素来标识文件夹。If you do not use this element, you must use the FolderId element to identify a folder.

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

DistinguishedFolderIdTypeDistinguishedFolderIdType

属性和元素Attributes and elements

下面各部分介绍了属性、子元素和父元素。The following sections describe attributes, child elements, and parent elements.

AttributesAttributes

属性Attribute 说明Description
IdId
包含标识默认文件夹的字符串。Contains a string that identifies a default folder. 此特性是必需的。This attribute is required.
ChangeKeyChangeKey
包含标识由Id属性标识的文件夹版本的字符串。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 属性值Id attribute values

Value 说明Description
日历calendar
代表 "日历" 文件夹。Represents the Calendar folder.
contactscontacts
代表 "联系人" 文件夹。Represents the Contacts folder.
deleteditemsdeleteditems
代表 "已删除邮件" 文件夹。Represents the Deleted Items folder.
draftsdrafts
代表 "草稿" 文件夹。Represents the Drafts folder.
inboxinbox
代表 "收件箱" 文件夹。Represents the Inbox folder.
日志journal
代表 "日记" 文件夹。Represents the Journal folder.
注释notes
代表 "便笺" 文件夹。Represents the Notes folder.
outboxoutbox
代表 "发件箱" 文件夹。Represents the Outbox folder.
sentitemssentitems
代表 "已发送邮件" 文件夹。Represents the Sent Items folder.
taskstasks
代表 "任务" 文件夹。Represents the Tasks folder.
msgfolderrootmsgfolderroot
表示邮件文件夹根目录。Represents the message folder root.
rootroot
表示邮箱的根。Represents the root of the mailbox.
junkemailjunkemail
代表 "垃圾邮件" 文件夹。Represents the Junk Email folder.
searchfolderssearchfolders
代表 "搜索文件夹" 文件夹。Represents the Search Folders folder.
语音邮件voicemail
代表 "语音邮件" 文件夹。Represents the Voice Mail folder.
recoverableitemsrootrecoverableitemsroot
表示转储程序根文件夹。Represents the dumpster root folder.
recoverableitemsdeletionsrecoverableitemsdeletions
代表 "转储程序删除" 文件夹。Represents the dumpster deletions folder.
recoverableitemsversionsrecoverableitemsversions
代表 "转储程序版本" 文件夹。Represents the dumpster versions folder.
recoverableitemspurgesrecoverableitemspurges
表示 "转储程序清除" 文件夹。Represents the dumpster purges folder.
archiverootarchiveroot
表示根存档文件夹。Represents the root archive folder.
archivemsgfolderrootarchivemsgfolderroot
代表 "根存档邮件" 文件夹。Represents the root archive message folder.
archivedeleteditemsarchivedeleteditems
代表 "存档已删除邮件" 文件夹。Represents the archive deleted items folder.
archiveinboxarchiveinbox
代表 "存档收件箱" 文件夹。Represents the archive Inbox folder. 从内部版本号开始的 Exchange 版本15.00.0913.09 包含此值。Versions of Exchange starting with build number 15.00.0913.09 include this value.
archiverecoverableitemsrootarchiverecoverableitemsroot
代表 "存档可恢复项目" 根文件夹。Represents the archive recoverable items root folder.
archiverecoverableitemsdeletionsarchiverecoverableitemsdeletions
代表 "存档可恢复项目删除" 文件夹。Represents the archive recoverable items deletions folder.
archiverecoverableitemsversionsarchiverecoverableitemsversions
代表 "存档可恢复项目版本" 文件夹。Represents the archive recoverable items versions folder.
archiverecoverableitemspurgesarchiverecoverableitemspurges
代表 "存档可恢复项目清除" 文件夹。Represents the archive recoverable items purges folder.
syncissuessyncissues
代表 "同步问题" 文件夹。Represents the sync issues folder.
conflictsconflicts
代表 "冲突" 文件夹。Represents the conflicts folder.
localfailureslocalfailures
代表 "本地故障" 文件夹。Represents the local failures folder.
serverfailuresserverfailures
代表 "服务器故障" 文件夹。Represents the server failures folder.
recipientcacherecipientcache
代表 "收件人缓存" 文件夹。Represents the recipient cache folder.
quickcontactsquickcontacts
代表 "快速联系人" 文件夹。Represents the quick contacts folder.
conversationhistoryconversationhistory
代表 "对话历史记录" 文件夹。Represents the conversation history folder.
adminauditlogsadminauditlogs
代表 "管理员审核日志" 文件夹。Represents the admin audit logs folder.
todosearchtodosearch
表示 todo 搜索文件夹。Represents the todo search folder.
mycontactsmycontacts
代表 "我的联系人" 文件夹。Represents the My Contacts folder.
文件夹directory
表示目录文件夹。Represents the directory folder.
imcontactlistimcontactlist
表示 IM 联系人列表文件夹。Represents the IM contact list folder.
peopleconnectpeopleconnect
代表 "人员连接" 文件夹。Represents the people connect folder.
精品favorites
代表 "收藏夹" 文件夹。Represents the Favorites folder.

子元素Child elements

元素Element 说明Description
MailboxMailbox
标识主 SMTP 地址。Identifies a primary SMTP address. 不允许使用代理地址。Proxy addresses are not allowed.

父元素Parent elements

元素Element 说明Description
ContextFolderIdContextFolderId
指示针对使用文件夹的对话操作的文件夹。Indicates the folder that is targeted for conversation actions that use folders.
DestinationFolderIdDestinationFolderId
指示用于复制和移动对话操作的目标文件夹。Indicates the destination folder for copy and move conversation actions.
ParentFolderId (TargetFolderIdType)ParentFolderId (TargetFolderIdType)
标识在其中创建新文件夹或项目的文件夹。Identifies the folder in which a new folder or item is created.

下面是此元素的 XPath 表达式:The following are the XPath expressions to this element:

/CreateItem/ParentFolderId

/CreateFolder/ParentFolderId
ParentFolderIdsParentFolderIds
标识用于搜索FindItem 操作FindFolder 操作的文件夹。Identifies folders to search for the FindItem operation and the FindFolder operation.
BaseFolderIdsBaseFolderIds
代表将搜索的文件夹的集合,以确定搜索文件夹的内容。Represents the collection of folders that will be searched to determine the contents of a search folder.
FolderIdsFolderIds
包含用于标识要复制、移动、获取、删除或监视事件通知的文件夹的文件夹标识符的数组。Contains an array of folder identifiers that are used to identify folders to copy, move, get, delete, or monitor for event notifications.
FolderChangeFolderChange
表示要在单个文件夹上进行的更改的集合。Represents a collection of changes to be performed on a single folder.

下面是此元素的 XPath 表达式: The following is the XPath expression to this element:

/UpdateFolder/FolderChanges/FolderChange
ToFolderIdToFolderId
代表复制或移动的项或文件夹的目标文件夹。Represents the destination folder for a copied or moved item or folder.

下面是此元素的 XPath 表达式:The following are the XPath expressions to this element:

/MoveFolder/ToFolderId

/CopyFolder/ToFolderId

/MoveItem/ToFolderId

/CopyItem/ToFolderId
SavedItemFolderIdSavedItemFolderId
标识在 Exchange 存储中更新、发送和创建项目的操作的目标文件夹。Identifies the target folder for operations that update, send, and create items in the Exchange store.

下面是此元素的 XPath 表达式:The following are the XPath expressions to this element:

/CreateItem/SavedItemFolderId

/UpdateItem/SavedItemFolderId

/SendItem/SavedItemFolderId
SyncFolderIdSyncFolderId
表示包含要同步的项目的文件夹。Represents the folder that contains the items to synchronize.
UserConfigurationNameUserConfigurationName
表示用户配置对象的名称。Represents the name of a user configuration object. "用户配置" 对象名称是 "用户配置" 对象的标识符。The user configuration object name is the identifier for a user configuration object.
CopyToFolderCopyToFolder
代表将电子邮件项目复制到的文件夹的 ID。Represents the ID of the folder that email items will be copied to.
MoveToFolderMoveToFolder
表示电子邮件项目将移动到的文件夹的 ID。Represents the ID of the folder that email items will be moved to.

文本值Text value

无。None.

说明Remarks

DistinguishedFolderId解析为FolderIdA DistinguishedFolderId resolves to a FolderId.

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

元素信息Element information

命名空间Namespace
https://schemas.microsoft.com/exchange/services/2006/types
架构名称Schema Name
类型架构Types schema
验证文件Validation File
Types.xsdTypes.xsd
可以为空Can be Empty
FalseFalse

另请参阅See also