Compartilhar via


Operação ResolveNames

A operação ResolveNames resolve endereços de email ambíguos e exibe nomes.

Usando a operação ResolveNames

Essa operação pode ser usada para verificar aliases e resolver nomes de exibição para o usuário da caixa de correio apropriado. Se houver nomes ambíguos, a resposta da operação ResolveNames fornecerá informações sobre cada usuário de caixa de correio para que o aplicativo cliente possa resolver os nomes.

Comentários

A resposta ResolveNames retorna no máximo 100 candidatos. Os 100 candidatos retornados são os primeiros 100 encontrados na operação de pesquisa.

Email endereços com tipos de roteamento prefixados, como smtp ou sip, são salvos em uma matriz multivalue. A operação ResolveNames executa uma correspondência parcial em relação a cada valor dessa matriz quando você adiciona o tipo de roteamento no início do nome não resolvido, como "sip:User1@Contoso.com". Se você não especificar um tipo de roteamento, ResolveNames será padrão para o tipo de roteamento de smtp, corresponda-o a uma propriedade de endereço smtp primário e não pesquise a matriz multivalue.

Somente um nome ambíguo pode ser especificado em uma única solicitação. O Active Directory é pesquisado primeiro e, em seguida, a pasta de contato do usuário é pesquisada. As entradas resolvidas da pasta de contato de um usuário têm uma propriedade ItemId não nula, que pode ser usada em uma solicitação GetItem. Se for a ID de uma lista de distribuição privada, ela poderá ser usada em uma operação ExpandDL. Se o atributo ReturnFullContactData for definido como true, as entradas do Active Directory encontradas com a operação ResolveNames retornarão propriedades adicionais que descrevem um Contato. O atributo ReturnFullContactData não afeta os dados retornados para contatos e listas de distribuição privadas da pasta de contato do usuário.

Exemplo de solicitação ResolveNames

Descrição

O exemplo a seguir de uma solicitação ResolveNames mostra como resolver a entrada do Usuário.

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>

Comments

A resposta a essa solicitação retornará todas as entradas que começam com "Jo" ou "Mi". Os itens retornados são caixas de correio públicas, listas de distribuição públicas e privadas e contatos.

Observação

Somente contatos na pasta contatos pessoais padrão são pesquisados.

A seguir estão os possíveis resultados para uma solicitação ResolveNames :

  • As respostas que não contêm uma entidade resolvida retornarão um valor de atributo ResponseClass igual a Error. O elemento MessageText conterá " Nenhum resultado foi encontrado".

  • As respostas que contêm uma única entidade resolvida retornarão um valor de atributo ResponseClass igual a Success.

  • As respostas que contêm várias entidades possíveis retornarão um valor de atributo ResponseClass igual a Aviso. Nesse caso, a entidade não pôde ser resolvida para uma identidade exclusiva. O elemento MessageText conterá "Vários resultados são encontrados".

Elementos de solicitação

Os seguintes elementos são usados na solicitação:

Exemplo de resposta à operação ResolveNames bem-sucedido

Descrição

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação 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 resposta resolvenames bem-sucedidos

Os seguintes elementos são usados na resposta:

Resposta de erro da operação ResolveNames

Descrição

O exemplo a seguir mostra uma resposta de erro a uma solicitação ResolveNames . O erro é causado pela tentativa de resolver um nome que não pode ser resolvido.

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 resposta de erro

Os seguintes elementos são usados na resposta de erro:

Confira também

Operação ExpandDL

Usando a Resolução de Nomes