RemoveImContactFromGroup operation
Find information about the RemoveImContactFromGroup EWS operation.
The RemoveImContactFromGroup operation removes a single IM contact from an IM group.
This operation was introduced in Exchange Server 2013.
Using the RemoveImContactFromGroup operation
The RemoveImContactFromGroup operation takes two arguments: a contact item identifier, and the corresponding instant messaging (IM) group from which the contact is removed.
RemoveImContactFromGroup operation SOAP headers
The RemoveImContactFromGroup operation can use the SOAP headers that are listed in the following table.
Header name | Element | Description |
---|---|---|
Impersonation |
ExchangeImpersonation |
Identifies the user whom the client application is impersonating. This header is applicable to a request. |
MailboxCulture |
MailboxCulture |
Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. This header is applicable to a request. |
RequestVersion |
RequestServerVersion |
Identifies the schema version for the operation request. This header is applicable to a request. |
ServerVersion |
ServerVersionInfo |
Identifies the version of the server that responded to the request. This header is applicable to a response. |
RemoveImContactFromGroup operation request example
The following example of a RemoveImContactFromGroup operation request shows how to remove an IM contact from an IM group.
Note
The group and contact identifiers have been shortened to preserve readability.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
<t:MailboxCulture>en-US</t:MailboxCulture>
</soap:Header>
<soap:Body >
<m:RemoveImContactFromGroup>
<m:ContactId Id="AAMkAGQ1MjJjMTBkLTcAAAAvcAAA="
ChangeKey="EQAAABYAAABtF8oI7iVOQ"/>
<m:GroupId Id="AAMkAGQ1MjJjMTBkbWAAAAAAQKAAA="
ChangeKey="EgAAAA=="/>
</m:RemoveImContactFromGroup>
</soap:Body>
</soap:Envelope>
The request SOAP body contains the following elements:
Successful RemoveImContactFromGroup operation response
The following example shows a successful response to a RemoveImContactFromGroup operation request.
<?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="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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">
<RemoveImContactFromGroupResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
</RemoveImContactFromGroupResponse>
</s:Body>
</s:Envelope>
The response SOAP body contains the following elements:
RemoveImContactFromGroup operation ErrorInvalidImContactId error response
The following example shows an error response to a RemoveImContactFromGroup operation request. The following error response occurs when an attempt is made to remove a contact item that does not exist in the 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="349"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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">
<RemoveImContactFromGroupResponse ResponseClass="Error"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>The specified Im Contact Id is invalid.</MessageText>
<ResponseCode>ErrorInvalidImContactId</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</RemoveImContactFromGroupResponse>
</s:Body>
</s:Envelope>
The response SOAP body contains the following elements: