Freigeben über

RemoveImGroup-Vorgang

  • Artikel

Hier finden Sie Informationen zum EWS-Vorgang "RemoveImGroup".

Der RemoveImGroup-Vorgang entfernt eine einzelne Chatgruppe aus einem Postfach.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des RemoveImGroup-Vorgangs

Der RemoveImGroup-Vorgang verwendet nur ein einzelnes Gruppenbezeichnerargument.

SOAP-Header des RemoveImGroup-Vorgangs

Der RemoveImGroup-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.

Headername Element Beschreibung
Impersonation
ExchangeImpersonation
Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt. Dieser Header gilt für eine Anforderung.
MailboxCulture
MailboxCulture
Identifiziert die Kultur, wie in RFC 3066 definiert, "Tags für die Identifizierung von Sprachen", die für den Zugriff auf das Postfach verwendet werden soll. Dieser Header gilt für eine Anforderung.
RequestVersion
RequestServerVersion
Gibt die Schemaversion für die Vorgangsanforderung an. Dieser Header gilt für eine Anforderung.
ServerVersion
ServerVersionInfo
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dieser Header gilt für eine Antwort.

Beispiel für removeImGroup-Vorgangsanforderung

Das folgende Beispiel einer RemoveImGroup-Vorgangsanforderung zeigt, wie eine Chatgruppe entfernt wird.

Hinweis

Die Gruppen-ID wurde gekürzt, um die Lesbarkeit zu gewährleisten.

<?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>

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Erfolgreiche RemoveImGroup-Vorgangsantwort

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine RemoveImGroup-Vorgangsanforderung.

<?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>

Der SOAP-Antworttext enthält die folgenden Elemente:

RemoveImGroup-Vorgang ErrorInvalidImGroupId-Fehlerantwort

Das folgende Beispiel zeigt eine Fehlerantwort auf eine RemoveImGroup-Vorgangsanforderung. Die folgende Fehlerantwort tritt auf, wenn versucht wird, eine Gruppe zu entfernen, die nicht im Postfach vorhanden ist.

<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>

Der SOAP-Textkörper der Fehlerantwort enthält die folgenden Elemente:

Weitere Fehlercodes, die für EWS generisch und für diesen Vorgang spezifisch sind, finden Sie unter ResponseCode.

RemoveImGroup-Vorgang ErrorInvalidIdMalformed-Fehlerantwort

Das folgende Beispiel zeigt eine Fehlerantwort auf eine RemoveImGroup-Vorgangsanforderung. Die folgende Fehlerantwort tritt auf, wenn versucht wird, eine Gruppe mit einem falsch formatierten Gruppenbezeichner zu entfernen.

<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>

Der SOAP-Textkörper der Fehlerantwort enthält die folgenden Elemente:

Siehe auch