ExchangeService.ResolveName Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| ResolveName(String, IEnumerable<FolderId>, ResolveNameSearchLocation, Boolean, PropertySet) |
Finds contacts in the Global Address List (GAL) and/or in specific contact folders whose names match the specified name.This method was introduced in the Exchange Web Services (EWS) Managed API 1.2. |
| ResolveName(String, IEnumerable<FolderId>, ResolveNameSearchLocation, Boolean) |
Finds contacts in specified contact folders and/or the Global Address List (GAL) that have names matching the name that was passed as a parameter. |
| ResolveName(String, ResolveNameSearchLocation, Boolean) |
Finds contacts in the default contacts folder and/or the Global Address List (GAL) that have names matching the name that was passed as a parameter. |
| ResolveName(String) |
Finds contacts in the user's Contacts folder and the Global Address List (GAL) — in that order — that have names matching the name that was passed as a parameter. |
| ResolveName(String, ResolveNameSearchLocation, Boolean, PropertySet) |
Finds contacts in the Global Address List (GAL) whose names match the specified name.This method was introduced in the Exchange Web Services (EWS) Managed API 1.2. |
ResolveName(String, IEnumerable<FolderId>, ResolveNameSearchLocation, Boolean, PropertySet)
Finds contacts in the Global Address List (GAL) and/or in specific contact folders whose names match the specified name.This method was introduced in the Exchange Web Services (EWS) Managed API 1.2.
public:
Microsoft::Exchange::WebServices::Data::NameResolutionCollection ^ ResolveName(System::String ^ nameToResolve, System::Collections::Generic::IEnumerable<Microsoft::Exchange::WebServices::Data::FolderId ^> ^ parentFolderIds, Microsoft::Exchange::WebServices::Data::ResolveNameSearchLocation searchScope, bool returnContactDetails, Microsoft::Exchange::WebServices::Data::PropertySet ^ contactDataPropertySet);public Microsoft.Exchange.WebServices.Data.NameResolutionCollection ResolveName (string nameToResolve, System.Collections.Generic.IEnumerable<Microsoft.Exchange.WebServices.Data.FolderId> parentFolderIds, Microsoft.Exchange.WebServices.Data.ResolveNameSearchLocation searchScope, bool returnContactDetails, Microsoft.Exchange.WebServices.Data.PropertySet contactDataPropertySet);Public Function ResolveName (nameToResolve As String, parentFolderIds As IEnumerable(Of FolderId), searchScope As ResolveNameSearchLocation, returnContactDetails As Boolean, contactDataPropertySet As PropertySet) As NameResolutionCollectionParameters
- nameToResolve
- String
The name to be resolved.
- parentFolderIds
- IEnumerable<FolderId>
The IDs of the contact folders to be searched for matching contacts.
- searchScope
- ResolveNameSearchLocation
The scope of the search.
- returnContactDetails
- Boolean
true if full contact information is to be returned for each of the found contacts; otherwise, false.
- contactDataPropertySet
- PropertySet
The property set for the contact details.
Returns
A collection of name resolutions whose names match the specified name.
Remarks
Calling this method results in a call to Exchange Web Service (EWS).
Applies to
ResolveName(String, IEnumerable<FolderId>, ResolveNameSearchLocation, Boolean)
Finds contacts in specified contact folders and/or the Global Address List (GAL) that have names matching the name that was passed as a parameter.
public:
Microsoft::Exchange::WebServices::Data::NameResolutionCollection ^ ResolveName(System::String ^ nameToResolve, System::Collections::Generic::IEnumerable<Microsoft::Exchange::WebServices::Data::FolderId ^> ^ parentFolderIds, Microsoft::Exchange::WebServices::Data::ResolveNameSearchLocation searchScope, bool returnContactDetails);public Microsoft.Exchange.WebServices.Data.NameResolutionCollection ResolveName (string nameToResolve, System.Collections.Generic.IEnumerable<Microsoft.Exchange.WebServices.Data.FolderId> parentFolderIds, Microsoft.Exchange.WebServices.Data.ResolveNameSearchLocation searchScope, bool returnContactDetails);Public Function ResolveName (nameToResolve As String, parentFolderIds As IEnumerable(Of FolderId), searchScope As ResolveNameSearchLocation, returnContactDetails As Boolean) As NameResolutionCollectionParameters
- nameToResolve
- String
The name to be resolved.
- parentFolderIds
- IEnumerable<FolderId>
The IDs of the contact folders to be searched for matching contacts.
- searchScope
- ResolveNameSearchLocation
The scope of the search.
- returnContactDetails
- Boolean
true to return for each of the contacts found in the search; otherwise, false.
Returns
A collection of name resolutions whose names match the one that was passed as a parameter.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
ResolveName(String, ResolveNameSearchLocation, Boolean)
Finds contacts in the default contacts folder and/or the Global Address List (GAL) that have names matching the name that was passed as a parameter.
public:
Microsoft::Exchange::WebServices::Data::NameResolutionCollection ^ ResolveName(System::String ^ nameToResolve, Microsoft::Exchange::WebServices::Data::ResolveNameSearchLocation searchScope, bool returnContactDetails);public Microsoft.Exchange.WebServices.Data.NameResolutionCollection ResolveName (string nameToResolve, Microsoft.Exchange.WebServices.Data.ResolveNameSearchLocation searchScope, bool returnContactDetails);Public Function ResolveName (nameToResolve As String, searchScope As ResolveNameSearchLocation, returnContactDetails As Boolean) As NameResolutionCollectionParameters
- nameToResolve
- String
The name to be resolved.
- searchScope
- ResolveNameSearchLocation
The scope of the search.
- returnContactDetails
- Boolean
true to return full contact information for each of the contacts found in the search; otherwise, false.
Returns
A collection of name resolutions whose names match the one that was passed as a parameter.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
ResolveName(String)
Finds contacts in the user's Contacts folder and the Global Address List (GAL) — in that order — that have names matching the name that was passed as a parameter.
public:
Microsoft::Exchange::WebServices::Data::NameResolutionCollection ^ ResolveName(System::String ^ nameToResolve);public Microsoft.Exchange.WebServices.Data.NameResolutionCollection ResolveName (string nameToResolve);Public Function ResolveName (nameToResolve As String) As NameResolutionCollectionParameters
- nameToResolve
- String
The name to be resolved.
Returns
A collection of name resolutions whose names match the one that was passed as a parameter.
Remarks
Calling this method results in a call to Exchange Web Services (EWS).
Applies to
ResolveName(String, ResolveNameSearchLocation, Boolean, PropertySet)
Finds contacts in the Global Address List (GAL) whose names match the specified name.This method was introduced in the Exchange Web Services (EWS) Managed API 1.2.
public:
Microsoft::Exchange::WebServices::Data::NameResolutionCollection ^ ResolveName(System::String ^ nameToResolve, Microsoft::Exchange::WebServices::Data::ResolveNameSearchLocation searchScope, bool returnContactDetails, Microsoft::Exchange::WebServices::Data::PropertySet ^ contactDataPropertySet);public Microsoft.Exchange.WebServices.Data.NameResolutionCollection ResolveName (string nameToResolve, Microsoft.Exchange.WebServices.Data.ResolveNameSearchLocation searchScope, bool returnContactDetails, Microsoft.Exchange.WebServices.Data.PropertySet contactDataPropertySet);Public Function ResolveName (nameToResolve As String, searchScope As ResolveNameSearchLocation, returnContactDetails As Boolean, contactDataPropertySet As PropertySet) As NameResolutionCollectionParameters
- nameToResolve
- String
The name to be resolved.
- searchScope
- ResolveNameSearchLocation
The scope of the search.
- returnContactDetails
- Boolean
true if full contact information is to be returned for each of the found contacts; otherwise, false.
- contactDataPropertySet
- PropertySet
The property set for the contact details.
Returns
A collection of name resolutions whose names match the specified name.
Remarks
Calling this method results in a call to Exchange Web Service (EWS).