Operación RemoveDistributionGroupFromImList

  • Artículo

Busque información sobre la operación EWS RemoveDistributionGroupFromImList .

La operación RemoveDistributionGroupFromImList quita un grupo de distribución de la lista de mensajería instantánea (MI) de Lync cuando Lync usa Exchange para el almacén de contactos.

Esta operación se introdujo en Exchange Server 2013.

Uso de la operación RemoveDistributionGroupFromImList

La operación RemoveDistributionGroupFromImList acepta un único argumento que identifica un grupo de distribución que se va a quitar de la lista de mensajería instantánea de Lync almacenada en un servidor exchange.

Encabezados SOAP de la operación RemoveDistributionGroupFromImList

La operación RemoveDistributionGroupFromImList puede usar los encabezados SOAP que aparecen en la tabla siguiente.

Nombre de encabezado Elemento Descripción
Suplantación
ExchangeImpersonation
Identifica al usuario al que suplanta la aplicación cliente. Este encabezado es aplicable a una solicitud.
MailboxCulture
MailboxCulture
Identifica la referencia cultural, tal como se define en RFC 3066, "Etiquetas para la identificación de idiomas", que se usará para acceder al buzón. Este encabezado es aplicable a una solicitud.
RequestVersion
RequestServerVersion
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud.
ServerVersion
ServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta.

Ejemplo de solicitud de operación RemoveDistributionGroupFromImList: Quitar un grupo de distribución de una lista de mensajería instantánea

En el ejemplo siguiente de una solicitud de operación RemoveDistributionGroupFromImList se muestra cómo quitar un grupo de distribución de un grupo de mensajería instantánea. La operación RemoveDistributionGroupFromImList acepta el identificador de grupo único para identificar el grupo de distribución que se va a quitar de la lista de mensajería instantánea. El elemento ExchangeStoreId que se devuelve en la respuesta para la operación GetImItemList y la operación AddDistributionGroupToImList identifica los grupos de distribución que se pueden quitar de la lista de mensajería instantánea.

Nota:

Todos los identificadores de elemento y las claves de cambio de este artículo se han acortado para conservar la legibilidad.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
   </soap:Header>
   <soap:Body >
      <m:RemoveDistributionGroupFromImList>
         <m:GroupId Id="AAMkADEzO4QrAABmEh5oAAA="/>
      </m:RemoveDistributionGroupFromImList>
   </soap:Body>
</soap:Envelope>

Los siguientes elementos se usan en el cuerpo soap de la solicitud:

Respuesta correcta de la operación RemoveDistributionGroupFromImList

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación RemoveDistributionGroupFromImList para quitar un grupo de distribución de un grupo de mensajería instantánea.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="556" 
                           MinorBuildNumber="8" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <RemoveDistributionGroupFromImListResponse ResponseClass="Success" 
                                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </RemoveDistributionGroupFromImListResponse>
   </s:Body>
</s:Envelope>

Los siguientes elementos se usan en el cuerpo soap de la respuesta:

Ejemplo de respuesta de error de la operación RemoveDistributionGroupFromImList

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación RemoveDistributionGroupFromImList . Se trata de una respuesta a una solicitud para quitar un grupo de distribución que ya se ha quitado del buzón.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="556" 
                           MinorBuildNumber="8" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <RemoveDistributionGroupFromImListResponse ResponseClass="Error" 
                                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified object was not found in the store.</MessageText>
         <ResponseCode>ErrorItemNotFound</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </RemoveDistributionGroupFromImListResponse>
   </s:Body>
</s:Envelope>

Los siguientes elementos se usan en el cuerpo SOAP de la respuesta de error:

Vea también