ResolveNames

Switch View :

ScriptFree

ResolveNames

The ResolveNames element defines a request to resolve ambiguous names.

Syntax


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

Type

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 with 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	Contact item identifier property is returned.
Default	The Default set of contact item properties are returned. See Web Service Response Shapes for more information.
AllProperties	The AllProperties set of contact item properties are returned. See Web Service Response Shapes for more information.

Child Elements

Element	Description
ParentFolderIds	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)so that some users may not have the rights to see some Active Directory objects. This element is optional.
UnresolvedEntry	Contains the name of a contact or distribution list to resolve.

Element

Description

ParentFolderIds

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)so that some users may not have the rights to see some Active Directory objects.

This element is optional.

UnresolvedEntry

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 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/messages
Schema name	Messages schema
Validation file	Messages.xsd
Can be empty	False

Reference

ResolveNames Operation
ResolveNamesType
ResolveNamesSearchScopeType

Other Resources

Exchange Web Services XML Elements
Using Name Resolution (Exchange Web Services)