Operação AddDistributionGroupToImListAddDistributionGroupToImList operation

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

A operação do AddDistributionGroupToImList do serviços Web do Exchange (EWS) adiciona um grupo de distribuição à lista de mensagens instantâneas (IM) no repositório unificado de contatos.The AddDistributionGroupToImList Exchange Web Services (EWS) operation adds a distribution group to the instant messaging (IM) list in the Unified Contact Store.

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

Usando a operação AddDistributionGroupToImListUsing the AddDistributionGroupToImList operation

A operação AddDistributionGroupToImList aceita um único argumento que identifica um grupo de distribuição para adicionar à lista de mensagens instantâneas.The AddDistributionGroupToImList operation takes a single argument that identifies a distribution group to add to the IM list. Essa operação não cria um grupo de distribuição; o grupo de distribuição já deve ser criado.This operation does not create a distribution group; the distribution group must already be created.

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

Tabela 1. Cabeçalhos SOAP de operação AddDistributionGroupToImListTable 1. AddDistributionGroupToImList operation SOAP headers

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. Isso se aplica a uma solicitação.This 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. Isso se aplica a uma solicitação.This 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. Isso se aplica a uma solicitação.This 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. Isso se aplica a uma resposta.This is applicable to a response.

Exemplo de solicitação de operação AddDistributionGroupToImListAddDistributionGroupToImList operation request example

O exemplo a seguir de uma solicitação de operação do AddDistributionGroupToImList mostra como adicionar um grupo de distribuição à lista de mensagens instantâneas.The following example of an AddDistributionGroupToImList operation request shows how to add a distribution group to the IM list.

<?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"
               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:AddDistributionGroupToImList>
         <m:SmtpAddress>distributionlist1@example.com</m:SmtpAddress>
      </m:AddDistributionGroupToImList>
   </soap:Body>
</soap:Envelope>

O corpo SOAP de solicitação contém os seguintes elementos:The request SOAP body contains the following elements:

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

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação AddDistributionGroupToImList .The following example shows a successful response to an AddDistributionGroupToImList operation request.

A resposta bem-sucedida contém o nome de exibição do grupo de distribuição, a classe de repositório do Exchange para o grupo de distribuição e o identificador do EWS do novo grupo de distribuição.The successful response contains the distribution group display name, the Exchange store class for the distribution group, and the EWS identifier of the new distribution group.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="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">
   <s:Header>
      <t:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013"/>
   </s:Header>
   <s:Body>
      <m:AddDistributionGroupToImListResponse ResponseClass="Success">
         <m:ResponseCode>NoError</m:ResponseCode>
         <m:ImGroup>
            <t:DisplayName>distributionlist1@example.com</t:DisplayName>
            <t:GroupType>IPM.DistList.MOC.DG</t:GroupType>
            <t:ExchangeStoreId Id="AAMkAGQ1MjJjAA=" 
                             ChangeKey="EgAAAA=="/>
      </m:ImGroup>
      </m:AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

O corpo SOAP de resposta contém os seguintes elementos:The response SOAP body contains the following elements:

Resposta de erro ErrorInvalidImDistributionGroupSmtpAddress operação AddDistributionGroupToImListAddDistributionGroupToImList operation ErrorInvalidImDistributionGroupSmtpAddress error response

O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação AddDistributionGroupToImList .The following example shows an error response to an AddDistributionGroupToImList operation request. A seguinte resposta de erro ocorre quando é feita uma tentativa de adicionar um grupo de distribuição que não existe no repositório do Exchange.The following error response occurs when an attempt is made to add a distribution group that does not exist in the Exchange store.

<?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="349" 
                           MinorBuildNumber="0" 
                           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">
      <AddDistributionGroupToImListResponse ResponseClass="Error" 
                                            xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified IM distribution group SMTP address is invalid.</MessageText>
         <ResponseCode>ErrorInvalidImDistributionGroupSmtpAddress</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

O corpo SOAP de resposta de erro contém os seguintes elementos:The error response SOAP body contains the following elements:

Confira tambémSee also