Edit

Share via


ResolveNamesType Class

Definition

The ResolveNamesType class represents a request to resolve names against the Active Directory directory service and a user's default Contacts folder.

public ref class ResolveNamesType : ExchangeWebServices::BaseRequestType
public class ResolveNamesType : ExchangeWebServices.BaseRequestType
Public Class ResolveNamesType
Inherits BaseRequestType
Inheritance
ResolveNamesType

Examples

The following code example shows you how to create a request to resolve an ambiguous name.

// Create the ResolveNamesType and set the unresolved entry.
ResolveNamesType rnRequest = new ResolveNamesType();
rnRequest.ReturnFullContactData = true;
rnRequest.UnresolvedEntry = "brianjb";

// Send the request and get the response.
ResolveNamesResponseType resolveNamesResponse = esb.ResolveNames(rnRequest);

Remarks

The ResolveNames response returns a maximum of 100 candidates. The 100 candidates that are returned are the first 100 that are encountered in the lookup operation.

Only one ambiguous name can be specified in a single request. Active Directory is searched first, and then the user's contact folder is searched. Resolved entries from a user's contact folder have a non-null ItemId property, which can be used in a GetItem request. If the ID is that of a private distribution list, it can be used in an ExpandDL operation. If the ReturnFullContactData property is set to true, Active Directory entries that are found by using the ResolveNames operation will return additional properties that describe a ContactItemType. The ReturnFullContactData property does not affect the data that is returned for contacts and private distribution lists from the user's contact folder.

Constructors

ResolveNamesType()

The ResolveNamesType constructor initializes a new instance of the ResolveNamesType class.

Properties

ContactDataShape
ContactDataShapeSpecified
ParentFolderIds
ReturnFullContactData

The ReturnFullContactData property gets or sets a Boolean value that specifies whether contact details for a public contact are returned in the response. This property is required. This is a read/write property.

SearchScope
UnresolvedEntry

The UnresolvedEntry property gets or sets a string that specifies an ambiguous name to resolve. This property is required. This is a read/write property.

Applies to