ResolveNames
Last modified: March 27, 2013
Applies to: Exchange Server 2007 | Exchange Server 2010
The ResolveNames element defines a request to resolve ambiguous names.
<ResolveNames ReturnFullContactData="" SearchScope="" ContactDataShape=””>
<ParentFolderIds/>
<UnresolvedEntry/>
</ResolveNames>
ResolveNamesType
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute |
Description |
|---|---|
ReturnFullContactData |
Describes whether the full contact details for public contacts for a resolved name are returned in the response. This attribute is required for public contacts. This value does not affect private contacts and private distribution lists, for which ItemId is always returned. |
SearchScope |
Identifies the order and scope for a ResolveNames search. |
ContactDataShape |
Identifies the property set returned for contacts. This attribute was introduced in Exchange Server 2010 Service Pack 2 (SP2). |
ReturnFullContactData Attribute Values
Value |
Description |
|---|---|
True |
Full contact details for public contacts are returned. |
False |
Full contact details for public contacts are not returned. |
SearchScope Attribute Values
Value |
Description |
|---|---|
ActiveDirectory |
Only the Active Directory directory service is searched. |
ActiveDirectoryContacts |
Active Directory is searched first, and then the contact folders that are specified in the ParentFolderIds property are searched. |
Contacts |
Only the contact folders that are identified by the ParentFolderIds property are searched. |
ContactsActiveDirectory |
Contact folders that are identified by the ParentFolderIds property are searched first and then Active Directory is searched. |
ContactDataShape Attribute Values
Value |
Description |
|---|---|
IdOnly |
The contact item identifier property is returned. |
Default |
The Default set of contact item properties is returned. See Web Service Response Shapes in Exchange 2010 for more information. |
AllProperties |
The AllProperties set of contact item properties is returned. For more information, see Web Service Response Shapes in Exchange 2010. |
Child Elements
Element |
Description |
|---|---|
Contains an array of contact folder identifiers that would be searched if the SearchScope attribute is set to ActiveDirectoryContacts, Contacts, or ContactsActiveDirectory. The ParentFolderIds array can only contain a single contact folder identifier. If the ParentFolderIds element is not present, the default Contacts folder is searched. The folder identifier can be used for delegate access. Active Directory searches are performed by using access control lists (ACLs). Some users might not have the rights to see some Active Directory objects. This element is optional. |
|
Contains the name of a contact or distribution list to resolve. |
Parent Elements
None.
Remarks
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/messages |
Schema name |
Messages schema |
Validation file |
Messages.xsd |
Can be empty |
False |
See Also