RemoveImContactFromGroup 操作RemoveImContactFromGroup operation

Removeimcontactfromgroup EWS 操作についての情報を検索します。Find information about the RemoveImContactFromGroup EWS operation.

Removeimcontactfromgroup操作は、im グループから1つの im 連絡先を削除します。The RemoveImContactFromGroup operation removes a single IM contact from an IM group.

この操作は Exchange Server 2013 で導入されました。This operation was introduced in Exchange Server 2013.

RemoveImContactFromGroup 操作の使用Using the RemoveImContactFromGroup operation

Removeimcontactfromgroup操作では、連絡先アイテムの識別子と、対応するインスタントメッセージング (IM) グループ (連絡先が削除される) の2つの引数を取ります。The RemoveImContactFromGroup operation takes two arguments: a contact item identifier, and the corresponding instant messaging (IM) group from which the contact is removed.

RemoveImContactFromGroup 操作 SOAP ヘッダーRemoveImContactFromGroup operation SOAP headers

Removeimcontactfromgroup操作では、次の表に示す SOAP ヘッダーを使用できます。The RemoveImContactFromGroup operation can use the SOAP headers that are listed in the following table.

ヘッダー名Header name 要素Element 説明Description
偽装Impersonation
ExchangeImpersonationExchangeImpersonation
クライアントアプリケーションが偽装しているユーザーを識別します。Identifies the user whom the client application is impersonating. このヘッダーは、要求に適用されます。This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
RFC 3066 で定義されているように、メールボックスへのアクセスに使用されるカルチャ (言語の識別用のタグ) を識別します。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.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
操作要求のスキーマバージョンを識別します。Identifies the schema version for the operation request. このヘッダーは、要求に適用されます。This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
要求に応答したサーバーのバージョンを識別します。Identifies the version of the server that responded to the request. このヘッダーは応答に適用されます。This header is applicable to a response.

RemoveImContactFromGroup 操作要求の例RemoveImContactFromGroup operation request example

次の例は、 Removeimcontactfromgroup操作要求の例で、im グループから im 連絡先を削除する方法を示しています。The following example of a RemoveImContactFromGroup operation request shows how to remove an IM contact from an IM group.

注意

読みやすくするために、グループと連絡先の識別子が短縮されています。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="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:RemoveImContactFromGroup>
         <m:ContactId Id="AAMkAGQ1MjJjMTBkLTcAAAAvcAAA="
                      ChangeKey="EQAAABYAAABtF8oI7iVOQ"/>
         <m:GroupId Id="AAMkAGQ1MjJjMTBkbWAAAAAAQKAAA="
                    ChangeKey="EgAAAA=="/>
      </m:RemoveImContactFromGroup>
   </soap:Body>
</soap:Envelope>

要求 SOAP 本文には、次の要素が含まれています。The request SOAP body contains the following elements:

RemoveImContactFromGroup 操作の応答が正常に行われるSuccessful RemoveImContactFromGroup operation response

次の例は、 Removeimcontactfromgroup操作要求に対する正常な応答を示しています。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="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">
      <RemoveImContactFromGroupResponse ResponseClass="Success" 
                                        xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </RemoveImContactFromGroupResponse>
   </s:Body>
</s:Envelope>

応答 SOAP 本文には、次の要素が含まれています。The response SOAP body contains the following elements:

RemoveImContactFromGroup 操作 ErrorInvalidImContactId エラー応答RemoveImContactFromGroup operation ErrorInvalidImContactId error response

次の例は、 Removeimcontactfromgroup操作要求へのエラー応答を示しています。The following example shows an error response to a RemoveImContactFromGroup operation request. IM グループに存在しない連絡先アイテムを削除しようとすると、次のエラー応答が発生します。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="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">
      <RemoveImContactFromGroupResponse ResponseClass="Error" 
                                        xmlns="https://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 本文には、次の要素が含まれています。The response SOAP body contains the following elements:

関連項目See also