ResolveNames-Vorgang

Artikel
03/29/2023

Der ResolveNames-Vorgang löst mehrdeutige E-Mail-Adressen und Anzeigenamen auf.

Verwenden des ResolveNames-Vorgangs

Dieser Vorgang kann verwendet werden, um Aliase zu überprüfen und Anzeigenamen für den entsprechenden Postfachbenutzer aufzulösen. Wenn mehrdeutige Namen vorhanden sind, enthält die Antwort des ResolveNames-Vorgangs Informationen zu den einzelnen Postfachbenutzern, damit die Clientanwendung die Namen auflösen kann.

Hinweise

Die ResolveNames-Antwort gibt maximal 100 Kandidaten zurück. Die zurückgegebenen 100 Kandidaten sind die ersten 100, die beim Nachschlagevorgang gefunden werden.

Email Adressen mit Routingtypen mit Präfix, z. B. smtp oder sip, werden in einem mehrwertigen Array gespeichert. Der ResolveNames-Vorgang führt eine partielle Übereinstimmung mit jedem Wert dieses Arrays durch, wenn Sie den Routingtyp am Anfang des nicht aufgelösten Namens hinzufügen, z. B. "sip:User1@Contoso.com". Wenn Sie keinen Routingtyp angeben, verwendet ResolveNames standardmäßig den Routingtyp smtp, zuordnen ihn mit einer primären SMTP-Adresseigenschaft und durchsucht nicht das mehrwertige Array.

In einer einzelnen Anforderung kann nur ein mehrdeutiger Name angegeben werden. Active Directory wird zuerst durchsucht, und dann wird der Kontaktordner des Benutzers durchsucht. Aufgelöste Einträge aus dem Kontaktordner eines Benutzers weisen eine ItemId-Eigenschaft ungleich NULL auf, die dann in einer GetItem-Anforderung verwendet werden kann. Wenn es sich um die ID einer privaten Verteilerliste handelt, kann sie in einem ExpandDL-Vorgang verwendet werden. Wenn das Attribut ReturnFullContactData auf true festgelegt ist, geben Active Directory-Einträge, die mit dem ResolveNames-Vorgang gefunden wurden, zusätzliche Eigenschaften zurück, die einen Kontakt beschreiben. Das Attribut ReturnFullContactData wirkt sich nicht auf die Daten aus, die für Kontakte und private Verteilerlisten aus dem Kontaktordner des Benutzers zurückgegeben werden.

ResolveNames-Anforderungsbeispiel

Beschreibung

Das folgende Beispiel einer ResolveNames-Anforderung zeigt, wie der Eintrag von User aufgelöst wird.

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>

Kommentare

Die Antwort auf diese Anforderung gibt alle Einträge zurück, die mit "Jo" oder "Mi" beginnen. Die zurückgegebenen Elemente sind öffentliche Postfächer, öffentliche und private Verteilerlisten sowie Kontakte.

Hinweis

Es werden nur Kontakte im standardmäßigen persönlichen Kontaktordner durchsucht.

Im Folgenden finden Sie die möglichen Ergebnisse für eine ResolveNames-Anforderung :

Antworten, die keine aufgelöste Entität enthalten, geben einen ResponseClass-Attributwert zurück, der gleich Error ist. Das MessageText-Element enthält " Es wurden keine Ergebnisse gefunden".
Antworten, die eine einzelne aufgelöste Entität enthalten, geben einen ResponseClass-Attributwert zurück, der dem Wert Success entspricht.
Antworten, die mehrere mögliche Entitäten enthalten, geben einen ResponseClass-Attributwert zurück, der gleich Warning ist. In diesem Fall konnte die Entität nicht in eine eindeutige Identität aufgelöst werden. Das MessageText-Element enthält "Mehrere Ergebnisse gefunden".

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Beispiel für eine erfolgreiche ResolveNames-Vorgangsantwort

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine ResolveNames-Anforderung .

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>

Erfolgreiche ResolveNames-Antwortelemente

In der Antwort werden folgende Elemente verwendet: