RemoveImContactFromGroup 操作
RemoveImContactFromGroup EWS 操作に関する情報を検索します。
RemoveImContactFromGroup 操作は、IM グループから 1 つの IM 連絡先を削除します。
この操作は Exchange Server 2013 で導入されました。
RemoveImContactFromGroup 操作の使用
RemoveImContactFromGroup 操作は、連絡先アイテム識別子と、連絡先が削除される対応するインスタント メッセージング (IM) グループの 2 つの引数を受け取ります。
RemoveImContactFromGroup 操作 SOAP ヘッダー
RemoveImContactFromGroup 操作では、次の表に示す SOAP ヘッダーを使用できます。
| ヘッダー名 | 要素 | 説明 |
|---|---|---|
| 偽装 |
ExchangeImpersonation |
クライアント アプリケーションが偽装しているユーザーを識別します。 このヘッダーは要求に適用されます。 |
| MailboxCulture |
MailboxCulture |
RFC 3066 で定義されている "言語の識別用タグ" で定義されているカルチャを識別し、メールボックスにアクセスするために使用します。 このヘッダーは要求に適用されます。 |
| RequestVersion |
RequestServerVersion |
操作要求のスキーマ バージョンを識別します。 このヘッダーは要求に適用されます。 |
| ServerVersion |
ServerVersionInfo |
要求に応答したサーバーのバージョンを識別します。 このヘッダーは、応答に適用できます。 |
RemoveImContactFromGroup 操作要求の例
RemoveImContactFromGroup 操作要求の次の例は、IM グループから IM 連絡先を削除する方法を示しています。
注:
読みやすくするために、グループと連絡先の識別子が短縮されました。
<?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>
要求 SOAP 本文には、次の要素が含まれています。
RemoveImContactFromGroup 操作の応答が成功しました
次の例は、 RemoveImContactFromGroup 操作要求に対する正常な応答を示しています。
<?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>
応答 SOAP 本文には、次の要素が含まれています。
RemoveImContactFromGroup 操作 ErrorInvalidImContactId エラー応答
次の例は、 RemoveImContactFromGroup 操作要求に対するエラー応答を示しています。 IM グループに存在しない連絡先アイテムを削除しようとすると、次のエラー応答が発生します。
<?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>
応答 SOAP 本文には、次の要素が含まれています。