Operación ExpandDLExpandDL operation

La operación ExpandDL expone toda la pertenencia a listas de distribución.The ExpandDL operation exposes the full membership of distribution lists.

Uso del método Web ExpandDLUsing the ExpandDL Web Method

La operación ExpandDL usa el servicio Web que se encuentra en Exchange. asmx.The ExpandDL operation uses the Web service that is located in Exchange.asmx. Este método de servicio web acepta un elemento Mailbox que puede contener un elemento secundario EmailAddress (NonEmptyStringType) para una expansión de una lista de distribución pública o un elemento secundario Itemid para la expansión de una lista de distribución 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.

Las listas de distribución públicas se pueden expandir con una de las siguientes opciones:Public distribution lists can be expanded by using one of the following:

  1. Alias de lista de distribuciónDistribution list alias

  2. Dirección del protocolo simple de transferencia de correo (SMTP)The Simple Mail Transfer Protocol (SMTP) address

  3. X.400X400

  4. X500X500

  5. Dirección heredada de ExchangeExchange Legacy address

  6. El nombre de la lista de distribuciónThe distribution list name

  7. El nombre para mostrarThe display name

Importante

Los nombres para mostrar no son únicos.Display names are not unique. Varias cuentas pueden compartir el mismo nombre para mostrar.Multiple accounts can share the same display name.

ComentariosRemarks

No se admite la expansión recursiva.Recursive expansion is not supported. Solo se puede expandir una lista de distribución en una sola llamada.Only one distribution list can be expanded in a single call. Si hay más de una lista de distribución que coincide con los criterios, el servicio Web notifica un error.If more than one distribution list match the criteria, the Web service reports an error. Una aplicación cliente puede usar la resolución de nombres ambiguos (ANR) para buscar listas de distribución ambiguas y, a continuación, elegir la dirección de correo electrónico correcta de la lista de distribución requerida como un parámetro para la operación 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 obtener más información, vea operación ResolveNames.For more information, see ResolveNames operation.

Las listas de distribución pública se encuentran en Active Directory.Public distribution lists are located in Active Directory. Pueden ser cualquier grupo de distribución dinámico o habilitado para correo.They can be any mail-enabled or dynamic distribution group. El grupo no debe estar oculto en la lista de direcciones y cada miembro debe tener una dirección de correo electrónico no vacía.The group should not be hidden from the address list and each member should have a non-empty e-mail address. Los miembros de la lista de distribución pueden estar habilitados para correo y contactos, carpetas públicas y listas de distribución habilitadas para correo y 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.

Las listas de distribución privadas se encuentran en la carpeta de contactos del buzón de un usuario.Private distribution lists are located in the Contacts folder of a user's mailbox. Las listas de distribución privadas no tienen direcciones de correo electrónico para que sus identificadores de elemento de almacén se usen en una solicitud de ExpandDL.Private distribution lists do not have e-mail addresses so their store item identifiers are used in an ExpandDL request. Los miembros de una lista de distribución privada pueden ser usuarios con correo habilitado, contactos o listas de distribución de Active Directory, o de listas de distribución privadas o contactos de una carpeta de contactos de un usuario.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 los contactos o listas de distribución privadas, los identificadores de elemento se devuelven en la respuesta.For contacts or private distribution lists, the item identifiers are returned in the response. Se puede usar para obtener información sobre el objeto o para expandir la pertenencia a una lista de distribución privada.This can be used to get information about the object or to expand membership in a private distribution list.

Ejemplo de solicitud de lista de distribución privada de ExpandDLExpandDL Private Distribution List request example

DescriptionDescription

El siguiente ejemplo de una solicitud ExpandDL muestra cómo crear una solicitud para expandir una lista de distribución 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>

ComentariosComments

Para expandir una lista de distribución privada, el elemento Mailbox contendrá el elemento Itemid que identifica una lista de distribución privada en el buzón del usuario.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.

Ejemplo de solicitud de lista de distribución pública de ExpandDLExpandDL Public Distribution List request example

DescriptionDescription

El siguiente ejemplo de una solicitud ExpandDL muestra cómo crear una solicitud para expandir una lista de distribución pública.The following example of an ExpandDL request shows how to form a request to expand a public distribution list. En el ejemplo se muestra el uso de un nombre para mostrar para expandir una lista de distribución.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>

ComentariosComments

La respuesta a esta solicitud contendrá elementos de buzón que identifican cada buzón de correo de la lista de distribución.The response to this request will contain Mailbox elements that identify each mailbox in the distribution list. Si una lista de distribución está contenida en una lista de distribución, debe realizarse una expansión de la lista de distribución independiente en la lista de distribución incrustada.If a distribution list is contained within a distribution list, a separate distribution list expansion must be performed on the embedded distribution list. Si la lista de distribución no tiene miembros o la lista de distribución solicitada no existe, el atributo ResponseClass contendrá un valor igual al correcto.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 de solicitudRequest elements

Los siguientes elementos se usan en la solicitud:The following elements are used in the request:

Nota

El esquema que describe estos elementos se encuentra en el directorio virtual de EWS del equipo que ejecuta MicrosoftExchange Server 2007 que tiene instalado el rol de servidor acceso de clientes.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.

Ejemplo de respuesta ExpandDL correctaSuccessful ExpandDL response example

DescriptionDescription

El siguiente ejemplo de una respuesta de ExpandDL muestra una respuesta a la solicitud descrita anteriormente.The following example of an ExpandDL response shows a response to the request described above. La expansión de la lista de distribución describe lo siguiente:The distribution list expansion describes the following:

  • Número de miembros de la lista de distribución que se devuelven en la respuesta.The number of members of the distribution list that are returned in the response.

  • Si la respuesta contiene todos los miembros de la lista de distribución.Whether the response contains all the members of the distribution list.

  • El nombre del buzón.The name of the mailbox.

  • La dirección de correo electrónico del buzón.The e-mail address of the mailbox.

  • El tipo de enrutamiento para el buzón.The routing type for the mailbox.

  • El tipo de buzón de correo.The type of mailbox.

Nota

El nombre de la lista de distribución no se incluye en la respuesta; por lo tanto, debe realizar un seguimiento del nombre de la solicitud.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 Response correctoSuccessful response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Para buscar otras opciones para el mensaje de respuesta de la operación ExpandDL, explore la jerarquía del esquema.To find other options for the response message of the ExpandDL operation, explore the schema hierarchy. Empiece en el elemento ExpandDLResponse .Start at the ExpandDLResponse element.

Respuesta de error de ExpandDLExpandDL error response

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta de error a una solicitud 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 respuesta de errorError response elements

Los siguientes elementos se usan en la respuesta de error:The following elements are used in the error response:

Para buscar otras opciones para el mensaje de respuesta de la operación ExpandDL, explore la jerarquía del esquema.To find other options for the response message of the ExpandDL operation, explore the schema hierarchy. Empiece en el elemento ExpandDLResponse .Start at the ExpandDLResponse element.

Vea tambiénSee also