ResolveNames

ResolveNames 元素定义解析不明确名称的请求。

<ResolveNames ReturnFullContactData="" SearchScope="" ContactDataShape="">
   <ParentFolderIds/>
   <UnresolvedEntry/>
</ResolveNames>

ResolveNamesType

属性和元素

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
ReturnFullContactData
描述是否在响应中返回已解析姓名的公共联系人的完整联系人详细信息。 公共联系人需要此属性。 此值不会影响始终返回 ItemId 的专用联系人和专用通讯组列表。
SearchScope
标识 ResolveNames 搜索的顺序和范围。
ContactDataShape
标识为联系人返回的属性集。 此属性已在 Exchange Server 2010 Service Pack 2 (SP2) 中引入。

ReturnFullContactData 属性值

说明
True
返回公共联系人的完整联系人详细信息。
错误
不会返回公共联系人的完整联系人详细信息。

SearchScope 属性值

说明
ActiveDirectory
仅搜索 Active Directory 目录服务。
ActiveDirectoryContacts
首先搜索 Active Directory,然后搜索 ParentFolderIds 属性中指定的联系人文件夹。
联系人
仅搜索 由 ParentFolderIds 属性标识的联系人文件夹。
ContactsActiveDirectory
首先搜索 由 ParentFolderIds 属性标识的联系人文件夹,然后搜索 Active Directory。

ContactDataShape 属性值

说明
IdOnly
返回联系人项标识符属性。
默认值
返回联系人项目属性的默认集。 有关详细信息,请参阅 EWS 中的响应形状
AllProperties
返回联系人项属性的 AllProperties 集。 有关详细信息,请参阅 EWS 中的响应形状

子元素

元素 说明
ParentFolderIds
包含联系人文件夹标识符数组,如果 SearchScope 属性设置为 ActiveDirectoryContacts、Contacts 或 ContactsActiveDirectory,则会搜索这些标识符。 ParentFolderIds 数组只能包含单个联系人文件夹标识符。 如果 ParentFolderIds 元素不存在,则搜索默认的“联系人”文件夹。
文件夹标识符可用于委托访问。
Active Directory 搜索通过使用访问控制列表 (ACL) 来执行。 某些用户可能无权查看某些 Active Directory 对象。
此元素为可选。
UnresolvedEntry
包含要解析的联系人或通讯组列表的名称。

父元素

无。

说明

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。

元素信息

名称
命名空间
https://schemas.microsoft.com/exchange/services/2006/messages
架构名称
消息架构
验证文件
Messages.xsd
可以为空
False

另请参阅