Operação RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation

Encontre informações sobre a operação do EWS do RemoveDistributionGroupFromImList .Find information about the RemoveDistributionGroupFromImList EWS operation.

A operação RemoveDistributionGroupFromImList remove um grupo de distribuição da lista de IM (mensagens instantâneas) do Lync quando o Lync usa o Exchange para o repositório de contatos.The RemoveDistributionGroupFromImList operation removes a distribution group from the Lync instant messaging (IM) list when Lync uses Exchange for the contact store.

This operation was introduced in Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Usando a operação RemoveDistributionGroupFromImListUsing the RemoveDistributionGroupFromImList operation

A operação RemoveDistributionGroupFromImList aceita um único argumento que identifica um grupo de distribuição a ser removido da lista de mensagens instantâneas do Lync armazenada em um servidor 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.

Cabeçalhos SOAP de operação RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation SOAP headers

A operação RemoveDistributionGroupFromImList pode usar os cabeçalhos SOAP listados na tabela a seguir.The RemoveDistributionGroupFromImList operation can use the SOAP headers that are listed in the following table.

Nome de cabeçalhoHeader name ElementoElement DescriçãoDescription
RepresentaçãoImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica o usuário que o aplicativo cliente está representando.Identifies the user whom the client application is impersonating. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica a cultura, conforme definido na RFC 3066, "marcas de identificação de idiomas", a ser usado para acessar a caixa de correio.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica a versão do esquema para a solicitação de operação.Identifies the schema version for the operation request. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação.Identifies the version of the server that responded to the request. Este cabeçalho é aplicável a uma resposta.This header is applicable to a response.

Exemplo de solicitação de operação RemoveDistributionGroupFromImList: remover um grupo de distribuição de uma lista de mensagens instantâneasRemoveDistributionGroupFromImList operation request example: Remove a distribution group from an IM list

O exemplo a seguir de uma solicitação de operação RemoveDistributionGroupFromImList mostra como remover um grupo de distribuição de um grupo de mensagens instantâneas.The following example of a RemoveDistributionGroupFromImList operation request shows how to remove a distribution group from an IM group. A operação RemoveDistributionGroupFromImList aceita o identificador de grupo exclusivo para identificar o grupo de distribuição a ser removido da lista de mensagens instantâneas.The RemoveDistributionGroupFromImList operation accepts the unique group identifier to identify the distribution group to remove from the IM list. O elemento ExchangeStoreId que é retornado na resposta para a operação GetImItemList e a operação AddDistributionGroupToImList identifica os grupos de distribuição que podem ser removidos da lista de mensagens instantâneas.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.

Observação

Todos os identificadores de item e as chaves de alteração deste artigo foram reduzidos para preservar a legibilidade.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>

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

Resposta de operação RemoveDistributionGroupFromImList bem-sucedidaSuccessful RemoveDistributionGroupFromImList operation response

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação RemoveDistributionGroupFromImList para um grupo de distribuição de um grupo de mensagens instantâneas.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>

Os seguintes elementos são usados no corpo SOAP de resposta:The following elements are used in the response SOAP body:

Exemplo de resposta de erro de operação RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation error response example

O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação RemoveDistributionGroupFromImList .The following example shows an error response to a RemoveDistributionGroupFromImList operation request. Esta é uma resposta a uma solicitação para remover um grupo de distribuição que já foi removido da caixa de correio.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>

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

Confira tambémSee also