Operação ExpandDLExpandDL operation

A operação ExpandDL expõe a associação completa de listas de distribuição.The ExpandDL operation exposes the full membership of distribution lists.

Usando o método Web ExpandDLUsing the ExpandDL Web Method

A operação ExpandDL usa o serviço Web localizado no Exchange. asmx.The ExpandDL operation uses the Web service that is located in Exchange.asmx. Este método de serviço Web aceita um elemento de caixa de correio que pode conter um elemento filho EmailAddress (NonEmptyStringType) para uma expansão de uma lista de distribuição pública ou um elemento filho ItemId para a expansão de uma lista de distribuição privada.This Web service method accepts a Mailbox element that can contain either an EmailAddress (NonEmptyStringType) child element for an expansion of a public distribution list or an ItemId child element for the expansion of a private distribution list.

As listas de distribuição pública podem ser expandidas usando um dos seguintes:Public distribution lists can be expanded by using one of the following:

  1. Alias da lista de distribuiçãoDistribution list alias

  2. O endereço do Protocolo SMTP SeguroThe Simple Mail Transfer Protocol (SMTP) address

  3. X400X400

  4. X500X500

  5. Endereço herdado do ExchangeExchange Legacy address

  6. O nome da lista de distribuiçãoThe distribution list name

  7. O nome de exibiçãoThe display name

Importante

Os nomes de exibição não são exclusivos.Display names are not unique. Várias contas podem compartilhar o mesmo nome de exibição.Multiple accounts can share the same display name.

ComentáriosRemarks

A expansão recursiva não é suportada.Recursive expansion is not supported. Apenas uma lista de distribuição pode ser expandida em uma única chamada.Only one distribution list can be expanded in a single call. Se mais de uma lista de distribuição corresponder aos critérios, o serviço Web relatará um erro.If more than one distribution list match the criteria, the Web service reports an error. Um aplicativo cliente pode usar a ANR (resolução de nomes ambíguos) para localizar listas de distribuição ambíguas e, em seguida, escolher o endereço de email correto da lista de distribuição necessária como um parâmetro para a operação ExpandDL.A client application can use ambiguous name resolution (ANR) to find ambiguous distribution lists and then chose the correct e-mail address of the required distribution list as a parameter for the ExpandDL operation. Para obter mais informações, consulte ResolveNames Operation.For more information, see ResolveNames operation.

As listas de distribuição pública estão localizadas no Active Directory.Public distribution lists are located in Active Directory. Eles podem ser qualquer grupo de distribuição dinâmico ou habilitado para email.They can be any mail-enabled or dynamic distribution group. O grupo não deve ser oculto na lista de endereços e cada membro deve ter um endereço de email não vazio.The group should not be hidden from the address list and each member should have a non-empty e-mail address. Os membros da lista de distribuição podem ser usuários e contatos habilitados para email, pastas públicas e listas de distribuição habilitadas para email e grupos dinâmicos.Members of the distribution list can be mail-enabled users and contacts, public folders, and mail-enabled distribution lists and dynamic groups.

As listas de distribuição privadas estão localizadas na pasta contatos da caixa de correio de um usuário.Private distribution lists are located in the Contacts folder of a user's mailbox. As listas de distribuição privada não têm endereços de email para que seus identificadores de item de repositório sejam usados em uma solicitação ExpandDL.Private distribution lists do not have e-mail addresses so their store item identifiers are used in an ExpandDL request. Os membros de uma lista de distribuição privada podem ser qualquer usuário habilitado para email, contatos ou listas de distribuição do Active Directory ou de contatos ou listas de distribuição privada da pasta contatos de um usuário.Members of a private distribution list can be any mail-enabled user, contacts or distribution lists from Active Directory, or contacts or private distribution lists from a user's Contacts folder.

Para contatos ou listas de distribuição privadas, os identificadores de item são retornados na resposta.For contacts or private distribution lists, the item identifiers are returned in the response. Isso pode ser usado para obter informações sobre o objeto ou para expandir a associação em uma lista de distribuição privada.This can be used to get information about the object or to expand membership in a private distribution list.

Exemplo de solicitação de lista de distribuição privada ExpandDLExpandDL Private Distribution List request example

DescriçãoDescription

O exemplo a seguir de uma solicitação ExpandDL mostra como formar uma solicitação para expandir uma lista de distribuição privada.The following example of an ExpandDL request shows how to form a request to expand a private distribution list.

CódigoCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2013_SP1" />
  </soap:Header>
  <soap:Body>
    <m:ExpandDL>
      <m:Mailbox>
       <t:EmailAddress>test</t:EmailAddress>
      </m:Mailbox>
    </m:ExpandDL>
  </soap:Body>
</soap:Envelope>

ComentáriosComments

Para expandir uma lista de distribuição privada, o elemento Mailbox conterá o elemento ItemId que identifica uma lista de distribuição privada na caixa de correio do usuário.To expand a private distribution list, the Mailbox element will contain the ItemId element that identifies a private distribution list in the user's mailbox.

Exemplo de solicitação de lista de distribuição pública do ExpandDLExpandDL Public Distribution List request example

DescriçãoDescription

O exemplo a seguir de uma solicitação ExpandDL mostra como formar uma solicitação para expandir uma lista de distribuição pública.The following example of an ExpandDL request shows how to form a request to expand a public distribution list. O exemplo mostra o uso de um nome de exibição para expandir uma lista de distribuição.The example shows the use of a display name to expand a distribution list.

CódigoCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <ExpandDL xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
              xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
        <t:Mailbox>
          <t:EmailAddress>TheDistributionList</t:EmailAddress>
        </t:Mailbox>
    </ExpandDL>
  </soap:Body>
</soap:Envelope>

ComentáriosComments

A resposta a essa solicitação conterá elementos de caixa de correio que identificam cada caixa de correio na lista de distribuição.The response to this request will contain Mailbox elements that identify each mailbox in the distribution list. Se uma lista de distribuição estiver contida em uma lista de distribuição, uma expansão de lista de distribuição separada deverá ser executada na lista de distribuição incorporada.If a distribution list is contained within a distribution list, a separate distribution list expansion must be performed on the embedded distribution list. Se a lista de distribuição não tiver membros ou a lista de distribuição solicitada não existir, o atributo ResponseClass conterá um valor igual a Success.If the distribution list has no members or the requested distribution list does not exist, the ResponseClass attribute will contain a value equal to Success.

Elementos RequestRequest elements

Os seguintes elementos são usados na solicitação:The following elements are used in the request:

Observação

O esquema que descreve esses elementos está localizado no diretório virtual do EWS do computador que está executando o MicrosoftExchange Server 2007 que tem a função de servidor de acesso para Cliente instalada.The schema that describes these elements is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

Exemplo de resposta ExpandDL bem-sucedidaSuccessful ExpandDL response example

DescriçãoDescription

O exemplo a seguir de uma resposta ExpandDL mostra uma resposta à solicitação descrita acima.The following example of an ExpandDL response shows a response to the request described above. A expansão da lista de distribuição descreve o seguinte:The distribution list expansion describes the following:

  • O número de membros da lista de distribuição que são retornados na resposta.The number of members of the distribution list that are returned in the response.

  • Se a resposta contém todos os membros da lista de distribuição.Whether the response contains all the members of the distribution list.

  • O nome da caixa de correio.The name of the mailbox.

  • O endereço de email da caixa de correio.The e-mail address of the mailbox.

  • O tipo de roteamento para a caixa de correio.The routing type for the mailbox.

  • O tipo de caixa de correio.The type of mailbox.

Observação

O nome da lista de distribuição não está incluído na resposta; Portanto, você deve acompanhar o nome da solicitação.The distribution list name is not included in the response; therefore, you must keep track of the name from the request.

CódigoCode

<?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="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ExpandDLResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:ExpandDLResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:DLExpansion TotalItemsInView="3" IncludesLastItemInRange="true">
            <t:Mailbox>
              <t:Name>Dan Park</t:Name>
              <t:EmailAddress>dpark@exampledomain.com</t:EmailAddress>
              <t:RoutingType>SMTP</t:RoutingType>
              <t:MailboxType>Mailbox</t:MailboxType>
            </t:Mailbox>
            <t:Mailbox>
              <t:Name>Jeff Price</t:Name>
              <t:EmailAddress>jprice@exampledomain.com</t:EmailAddress>
              <t:RoutingType>SMTP</t:RoutingType>
              <t:MailboxType>Mailbox</t:MailboxType>
            </t:Mailbox>
            <t:Mailbox>
              <t:Name>Tanja Plate</t:Name>
              <t:EmailAddress>tplate@exampledomain.com</t:EmailAddress>
              <t:RoutingType>SMTP</t:RoutingType>
              <t:MailboxType>Mailbox</t:MailboxType>
            </t:Mailbox>
          </m:DLExpansion>
        </m:ExpandDLResponseMessage>
      </m:ResponseMessages>
    </ExpandDLResponse>
  </soap:Body>
</soap:Envelope>

Elementos de resposta bem-sucedidosSuccessful response elements

Os seguintes elementos são usados na resposta:The following elements are used in the response:

Para encontrar outras opções para a mensagem de resposta da operação ExpandDL, explore a hierarquia do esquema.To find other options for the response message of the ExpandDL operation, explore the schema hierarchy. Inicie no elemento ExpandDLResponse .Start at the ExpandDLResponse element.

Resposta de erro ExpandDLExpandDL error response

DescriçãoDescription

O exemplo a seguir mostra uma resposta de erro a uma solicitação ExpandDL.The following example shows an error response to an ExpandDL request.

CódigoCode

<?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="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ExpandDLResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                      xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                      xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:ExpandDLResponseMessage ResponseClass="Error">
          <m:MessageText>No results are found.</m:MessageText>
          <m:ResponseCode>ErrorNameResolutionNoResults</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:ExpandDLResponseMessage>
      </m:ResponseMessages>
    </ExpandDLResponse>
  </soap:Body>
</soap:Envelope>

Elementos de resposta de erroError response elements

Os seguintes elementos são usados na resposta de erro:The following elements are used in the error response:

Para encontrar outras opções para a mensagem de resposta da operação ExpandDL, explore a hierarquia do esquema.To find other options for the response message of the ExpandDL operation, explore the schema hierarchy. Inicie no elemento ExpandDLResponse .Start at the ExpandDLResponse element.

Confira tambémSee also