Partager via

Opération ResolveNames

  • Article

L’opération ResolveNames résout les adresses e-mail et les noms d’affichage ambigus.

Utilisation de l’opération ResolveNames

Cette opération peut être utilisée pour vérifier les alias et résoudre les noms d’affichage de l’utilisateur de boîte aux lettres approprié. S’il existe des noms ambigus, la réponse de l’opération ResolveNames fournit des informations sur chaque utilisateur de boîte aux lettres afin que l’application cliente puisse résoudre les noms.

Remarques

La réponse ResolveNames retourne un maximum de 100 candidats. Les 100 candidats retournés sont les 100 premiers rencontrés dans l’opération de recherche.

Email adresses avec des types de routage préfixés, tels que smtp ou sip, sont enregistrées dans un tableau à valeurs multiples. L’opération ResolveNames effectue une correspondance partielle avec chaque valeur de ce tableau lorsque vous ajoutez le type de routage au début du nom non résolu, tel que « sip:User1@Contoso.com ». Si vous ne spécifiez pas de type de routage, ResolveNames utilise par défaut le type de routage smtp, le met en correspondance avec une propriété d’adresse smtp principale et ne recherche pas dans le tableau à valeurs multiples.

Un seul nom ambigu peut être spécifié dans une seule requête. Active Directory fait d’abord l’objet d’une recherche, puis le dossier de contacts de l’utilisateur est recherché. Les entrées résolues du dossier de contacts d’un utilisateur ont une propriété ItemId non null, qui peut ensuite être utilisée dans une requête GetItem. S’il s’agit de l’ID d’une liste de distribution privée, il peut être utilisé dans une opération ExpandDL. Si l’attribut ReturnFullContactData est défini sur true, les entrées Active Directory trouvées avec l’opération ResolveNames retournent des propriétés supplémentaires qui décrivent un contact. L’attribut ReturnFullContactData n’affecte pas les données retournées pour les contacts et les listes de distribution privées à partir du dossier de contacts de l’utilisateur.

Exemple de requête ResolveNames

Description

L’exemple suivant de demande ResolveNames montre comment résoudre l’entrée de User.

Code

<?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>

Comments

La réponse à cette demande retourne toutes les entrées qui commencent par « Jo » ou « Mi ». Les éléments retournés sont des boîtes aux lettres publiques, des listes de distribution publiques et privées et des contacts.

Remarque

Seuls les contacts du dossier Contacts personnels par défaut font l’objet d’une recherche.

Voici les résultats possibles d’une demande ResolveNames :

  • Les réponses qui ne contiennent pas d’entité résolue retournent une valeur d’attribut ResponseClass égale à Error. L’élément MessageText contient « Aucun résultat n’est trouvé ».

  • Les réponses qui contiennent une seule entité résolue retournent une valeur d’attribut ResponseClass égale à Success.

  • Les réponses qui contiennent plusieurs entités possibles retournent une valeur d’attribut ResponseClass égale à Warning. Dans ce cas, l’entité n’a pas pu être résolue en une identité unique. L’élément MessageText contient « Plusieurs résultats sont trouvés ».

Éléments de requête

Les éléments suivants sont utilisés dans la demande :

Exemple de réponse d’opération ResolveNames réussie

Description

L’exemple suivant montre une réponse réussie à une demande ResolveNames .

Code

<?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>

Éléments de réponse ResolveNames réussis

Les éléments suivants sont utilisés dans la réponse :

Réponse d’erreur d’opération ResolveNames

Description

L’exemple suivant montre une réponse d’erreur à une requête ResolveNames . L’erreur est due à la tentative de résolution d’un nom qui ne peut pas être résolu.

Code

<?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>

Éléments de réponse d’erreur

Les éléments suivants sont utilisés dans la réponse d'erreur :

Voir aussi

Opération ExpandDL

Utilisation de la résolution de noms