Operación RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation

Buscar información sobre la operación de EWS de RemoveDistributionGroupFromImList .Find information about the RemoveDistributionGroupFromImList EWS operation.

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.The RemoveDistributionGroupFromImList operation removes a distribution group from the Lync instant messaging (IM) list when Lync uses Exchange for the contact store.

Esta operación se introdujo en Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Uso de la operación RemoveDistributionGroupFromImListUsing the RemoveDistributionGroupFromImList operation

La operación RemoveDistributionGroupFromImList acepta un único argumento que identifica un grupo de distribución que se quitará de la lista de mensajería instantánea de Lync almacenada en un servidor de Exchange.The RemoveDistributionGroupFromImList operation accepts a single argument that identifies a distribution group to remove from the Lync IM list stored on an Exchange server.

Encabezados SOAP de operación RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation SOAP headers

La operación RemoveDistributionGroupFromImList puede usar los encabezados SOAP que se enumeran en la tabla siguiente.The RemoveDistributionGroupFromImList operation can use the SOAP headers that are listed in the following table.

Nombre de encabezadoHeader name ElementoElement DescripciónDescription
SuplantaciónImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica al usuario que está suplantando la aplicación cliente.Identifies the user whom the client application is impersonating. Este encabezado se aplica a una solicitud.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica la referencia cultural, tal y como se define en RFC 3066, "etiquetas para la identificación de idiomas", que se va a usar para obtener acceso al buzón.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Este encabezado se aplica a una solicitud.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica la versión del esquema para la solicitud de operación.Identifies the schema version for the operation request. Este encabezado se aplica a una solicitud.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.Identifies the version of the server that responded to the request. Este encabezado se aplica a una respuesta.This header is applicable to a response.

Ejemplo de solicitud de operación RemoveDistributionGroupFromImList: quitar un grupo de distribución de una lista de mensajes instantáneosRemoveDistributionGroupFromImList operation request example: Remove a distribution group from an IM list

El siguiente ejemplo de una solicitud de operación de RemoveDistributionGroupFromImList muestra cómo quitar un grupo de distribución de un grupo de mensajería instantánea.The following example of a RemoveDistributionGroupFromImList operation request shows how to remove a distribution group from an IM group. 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.The RemoveDistributionGroupFromImList operation accepts the unique group identifier to identify the distribution group to remove from the IM list. El elemento ExchangeStoreId que se devuelve en la respuesta de la operación GetImItemList y la operación AddDistributionGroupToImList identifica los grupos de distribución que pueden quitarse de la lista de mi.The ExchangeStoreId element that is returned in the response for the GetImItemList operation and the AddDistributionGroupToImList operation identifies distribution groups that can be removed from the IM list.

Nota

Todos los identificadores de elemento y las claves de cambio de este artículo se han reducido para preservar la legibilidad.All item identifiers and change keys in this article have been shortened to preserve readability.

<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:The following elements are used in the request SOAP body:

Respuesta de operación RemoveDistributionGroupFromImList correctaSuccessful RemoveDistributionGroupFromImList operation response

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación RemoveDistributionGroupFromImList en un grupo de distribución de mensajería instantánea.The following example shows a successful response to a RemoveDistributionGroupFromImList operation request to a remove a distribution group from an IM group.

<?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:The following elements are used in the response SOAP body:

Ejemplo de respuesta de error de operación RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation error response example

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación RemoveDistributionGroupFromImList .The following example shows an error response to a RemoveDistributionGroupFromImList operation request. Se trata de una respuesta a una solicitud para quitar un grupo de distribución que ya se ha quitado del buzón.This is a response to a request to remove a distribution group that has already been removed from the mailbox.

<?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 respuesta de error:The following elements are used in the error response SOAP body:

Vea tambiénSee also