Operación ResolveNames
La operación ResolveNames resuelve direcciones de correo electrónico ambiguas y nombres para mostrar.
Uso de la operación ResolveNames
Esta operación se puede usar para comprobar los alias y resolver los nombres para mostrar para el usuario de buzón adecuado. Si existen nombres ambiguos, la respuesta de la operación ResolveNames proporciona información sobre cada usuario de buzón de correo para que la aplicación cliente pueda resolver los nombres.
Comentarios
La respuesta ResolveNames devuelve un máximo de 100 candidatos. Los 100 candidatos que se devuelven son los primeros 100 que se encuentran en la operación de búsqueda.
Email direcciones con tipos de enrutamiento con prefijo, como smtp o sip, se guardan en una matriz de varios valores. La operación ResolveNames realiza una coincidencia parcial con cada valor de esa matriz al agregar el tipo de enrutamiento al principio del nombre sin resolver, como "sip:User1@Contoso.com". Si no especifica un tipo de enrutamiento, ResolveNames tendrá como valor predeterminado el tipo de enrutamiento smtp, lo coincidirá con una propiedad de dirección smtp principal y no buscará en la matriz multivalor.
Solo se puede especificar un nombre ambiguo en una sola solicitud. Active Directory se busca primero y, a continuación, se busca en la carpeta de contactos del usuario. Las entradas resueltas de la carpeta de contacto de un usuario tienen una propiedad ItemId que no es null, que se puede usar en una solicitud GetItem. Si es el identificador de una lista de distribución privada, se puede usar en una operación ExpandDL. Si el atributo ReturnFullContactData se establece en true, las entradas de Active Directory encontradas con la operación ResolveNames devolverán propiedades adicionales que describen un contacto. El atributo ReturnFullContactData no afecta a los datos que se devuelven para los contactos y las listas de distribución privadas de la carpeta de contactos del usuario.
Ejemplo de solicitud ResolveNames
Descripción
En el ejemplo siguiente de una solicitud ResolveNames se muestra cómo resolver la entrada de User.
Código
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<ResolveNames xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
ReturnFullContactData="true">
<UnresolvedEntry>User2</UnresolvedEntry>
</ResolveNames>
</soap:Body>
</soap:Envelope>
Comentarios
La respuesta a esta solicitud devolverá todas las entradas que comiencen por "Jo" o "Mi". Los elementos devueltos son buzones públicos, listas de distribución públicas y privadas y contactos.
Nota:
Solo se buscan los contactos de la carpeta contactos personales predeterminada.
A continuación se muestran los posibles resultados de una solicitud ResolveNames :
Las respuestas que no contienen una entidad resuelta devolverán un valor de atributo ResponseClass igual a Error. El elemento MessageText contendrá " No se encontraron resultados".
Las respuestas que contienen una sola entidad resuelta devolverán un valor de atributo ResponseClass igual a Correcto.
Las respuestas que contienen varias entidades posibles devolverán un valor de atributo ResponseClass igual a Warning. En este caso, la entidad no se pudo resolver en una identidad única. El elemento MessageText contendrá "Se encontraron varios resultados".
Elementos Request
En la solicitud se usan los siguientes elementos:
Ejemplo de respuesta correcta de la operación ResolveNames
Descripción
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud ResolveNames .
Código
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="685" MinorBuildNumber="8"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<ResolveNamesResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:ResolveNamesResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:ResolutionSet TotalItemsInView="1" IncludesLastItemInRange="true">
<t:Resolution>
<t:Mailbox>
<t:Name>User2</t:Name>
<t:EmailAddress>User2@example.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
<t:MailboxType>Mailbox</t:MailboxType>
</t:Mailbox>
<t:Contact>
<t:DisplayName>User2</t:DisplayName>
<t:EmailAddresses>
<t:Entry Key="EmailAddress1">SMTP:User2@example.com</t:Entry>
</t:EmailAddresses>
<t:ContactSource>ActiveDirectory</t:ContactSource>
</t:Contact>
</t:Resolution>
</m:ResolutionSet>
</m:ResolveNamesResponseMessage>
</m:ResponseMessages>
</ResolveNamesResponse>
</soap:Body>
</soap:Envelope>
Elementos de respuesta ResolveNames correctos
Los siguientes elementos se usan en la respuesta:
Respuesta de error de la operación ResolveNames
Descripción
En el ejemplo siguiente se muestra una respuesta de error a una solicitud ResolveNames . El error se debe a que se intenta resolver un nombre que no se puede resolver.
Código
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="685" MinorBuildNumber="8"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<ResolveNamesResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:ResolveNamesResponseMessage ResponseClass="Error">
<m:MessageText>No results were found.</m:MessageText>
<m:ResponseCode>ErrorNameResolutionNoResults</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:ResolveNamesResponseMessage>
</m:ResponseMessages>
</ResolveNamesResponse>
</soap:Body>
</soap:Envelope>
Elementos de respuesta de error
Los siguientes elementos se usan en la respuesta de error: