Поделиться через

Операция RemoveImGroup

  • Статья

Сведения об операции RemoveImGroup EWS.

Операция RemoveImGroup удаляет одну группу мгновенных сообщений (IM) из почтового ящика.

Эта операция появилась в Exchange Server 2013.

Использование операции RemoveImGroup

Операция RemoveImGroup принимает только один аргумент идентификатора группы.

RemoveImGroup operation SOAP headers

Операция RemoveImGroup может использовать заглавные таблицы SOAP, перечисленные в следующей таблице.

Имя заголовка Элемент Описание
Олицетворение
ExchangeImpersonation
Определяет пользователя, которого клиентская заявка выдвигает. Этот заглавный заглавник применим к запросу.
MailboxCulture
MailboxCulture
Определяет культуру, определяемую в RFC 3066 , "Теги для идентификации языков", которая будет использоваться для доступа к почтовому ящику. Этот заглавный заглавник применим к запросу.
RequestVersion
RequestServerVersion
Определяет версию схемы для запроса на операцию. Этот заглавный заглавник применим к запросу.
ServerVersion
ServerVersionInfo
Определяет версию сервера, отвечаемого на запрос. Этот заглавный заглавник применим к ответу.

Пример запроса на операцию RemoveImGroup

В следующем примере запроса на операцию RemoveImGroup показано, как удалить группу im.

Примечание

Для сохранения читаемости был сокращен ИД группы.

<?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:RemoveImGroup>
         <m:GroupId Id="AAMkAGQ1MjJjMTBkLTc4Y2UtNDA5hQoTbWAAAAAAQRAAA="
                    ChangeKey="EgAAAA=="/>
      </m:RemoveImGroup>
   </soap:Body>
</soap:Envelope>

Тело SOAP запроса содержит следующие элементы:

Успешный ответ на операцию RemoveImGroup

В следующем примере показан успешный ответ на запрос на операцию RemoveImGroup.

<?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">
      <RemoveImGroupResponse ResponseClass="Success" 
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </RemoveImGroupResponse>
   </s:Body>
</s:Envelope>

Тело SOAP ответа содержит следующие элементы:

RemoveImGroup operation ErrorInvalidImGroupId error response

В следующем примере показан ответ на ошибку запроса на операцию RemoveImGroup. Следующий ответ на ошибку возникает при попытке удалить группу, которая не существует в почтовом ящике.

<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">
      <RemoveImGroupResponse ResponseClass="Error" 
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified Im Group Id is invalid.</MessageText>
         <ResponseCode>ErrorInvalidImGroupId</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </RemoveImGroupResponse>
   </s:Body>
</s:Envelope>

Тело SOAP ответа на ошибку содержит следующие элементы:

Дополнительные коды ошибок, общие для EWS и специфические для этой операции, см. в ответе.

RemoveImGroup operation ErrorInvalidIdMalformed error response

В следующем примере показан ответ на ошибку запроса на операцию RemoveImGroup. Следующий ответ на ошибку возникает при попытке удалить группу с неправильно отформатированным идентификатором группы.

<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">
      <RemoveImGroupResponse ResponseClass="Error" 
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>Id is malformed.</MessageText>
         <ResponseCode>ErrorInvalidIdMalformed</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </RemoveImGroupResponse>
   </s:Body>
</s:Envelope>

Тело SOAP ответа на ошибку содержит следующие элементы:

См. также