RemoveContactFromImList 操作

  • [アーティクル]

RemoveContactFromImList EWS 操作に関する情報を検索します。

RemoveContactFromImList 操作では、Lync が連絡先ストアに対して連絡先を使用するときに、Lync インスタント メッセージング (IM) リストから連絡先Exchange削除します。

この操作は Exchange Server 2013 で導入されました。

RemoveContactFromImList 操作の使用

RemoveContactFromImList 操作は、連絡先サーバーに保存されている Lync 連絡先リストから削除する連絡先を識別する 1 つの引数Exchangeします。 この操作の対象となる連絡先の一覧は、2013 年に Lync 連絡先 Outlookされます。

注意事項

連絡先リストから連絡先 を削除するには、DeleteItem 操作を使用しない。 Lync 連絡先リストからの連絡先の削除をサポートするために、サーバー側の追加処理 が必要になる場合 があります。 Lync 連絡先リスト は、既定 の Lync 連絡先メールボックス フォルダーの概 念に相当します 。

RemoveContactFromImList 操作 SOAP ヘッダー

RemoveContactFromImList 操作では、次の表に示す SOAP ヘッダーを使用できます。

ヘッダー名 Element 説明
偽装
ExchangeImpersonation
クライアント アプリケーションが偽装しているユーザーを識別します。 このヘッダーは、要求に適用されます。
MailboxCulture
MailboxCulture
メールボックスへのアクセスに使用する RFC 3066「言語の識別用タグ」で定義されているカルチャを識別します。 このヘッダーは、要求に適用されます。
RequestVersion
RequestServerVersion
操作要求のスキーマ バージョンを識別します。 このヘッダーは、要求に適用されます。
ServerVersion
ServerVersionInfo
要求に応答したサーバーのバージョンを識別します。 このヘッダーは、応答に適用されます。

RemoveContactFromImList 操作要求の例: Lync 連絡先リストから連絡先を削除する

RemoveContactFromImList 操作要求の次の例は、Lync 連絡先リストから連絡先を削除 する方法を示 しています。 RemoveContactFromImList 操作は、Lync 連絡先リストから削除された連絡先を識別する 1 つの一意の連絡先識別子 を受け入 れます。

注意

この記事のすべてのアイテム識別子と変更キーは、読みやすさを維持するために短縮されています。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
   </soap:Header>
   <soap:Body>
      <m:RemoveContactFromImList>
         <m:ContactId Id=""/>
      </m:RemoveContactFromImList>
   </soap:Body>
</soap:Envelope>

要求 SOAP 本文では、次の要素が使用されます。

成功した RemoveContactFromImList 操作応答

次の例は、Lync 連絡先リストから連絡先を削除する RemoveContactFromImList 操作要求に対する正常な応答 を示 しています。

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

応答 SOAP 本文では、次の要素が使用されます。

RemoveContactFromImList 操作エラー応答

次の例は 、RemoveContactFromImList 操作要求に対するエラー応答を示しています。 これは、連絡先がリストに存在しなくなったときに Lync 連絡先 リストから連絡先を削除する要求に対する応答です。

<?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="556" 
                           MinorBuildNumber="8" 
                           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">
      <RemoveContactFromImListResponse ResponseClass="Error" 
                                       xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified object was not found in the store.</MessageText>
         <ResponseCode>ErrorItemNotFound</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </RemoveContactFromImListResponse>
   </s:Body>
</s:Envelope>

エラー応答 SOAP 本文では、次の要素が使用されます。

関連項目