Freigeben über

RemoveContactFromImList-Vorgang

  • Artikel

Hier finden Sie Informationen zum EWS-Vorgang RemoveContactFromImList .

Der RemoveContactFromImList-Vorgang entfernt Kontakte aus der Lync-Chatliste, wenn Lync Exchange für den Kontaktspeicher verwendet.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des RemoveContactFromImList-Vorgangs

Der RemoveContactFromImList-Vorgang akzeptiert ein einzelnes Argument, das einen Kontakt identifiziert, der aus der auf einem Exchange-Server gespeicherten Lync-Kontaktliste entfernt werden soll. Die Liste der Kontakte, auf die dieser Vorgang abzielt, wird in Outlook 2013 als Lync-Kontakte bezeichnet.

Vorsicht

Verwenden Sie den DeleteItem-Vorgang nicht, um Kontakte aus einer Kontaktliste zu entfernen. Möglicherweise muss eine zusätzliche serverseitige Verarbeitung erfolgen, um das Entfernen eines Kontakts aus der Lync-Kontaktliste zu unterstützen. Beachten Sie, dass die Lync-Kontaktliste die konzeptionelle Entsprechung des Standardmäßigen Lync-Kontaktpostfachordners ist.

SOAP-Header des RemoveContactFromImList-Vorgangs

Der RemoveContactFromImList-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 "Tags für die Identifizierung von Sprachen" definiert, 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.

RemoveContactFromImList-Vorgangsanforderungsbeispiel: Entfernen eines Kontakts aus der Lync-Kontaktliste

Das folgende Beispiel einer RemoveContactFromImList-Vorgangsanforderung zeigt, wie ein Kontakt aus der Lync-Kontaktliste entfernt wird. Der RemoveContactFromImList-Vorgang akzeptiert einen einzelnen eindeutigen Kontaktbezeichner, um den Kontakt zu identifizieren, der aus der Lync-Kontaktliste entfernt wird.

Hinweis

Alle Elementbezeichner und Änderungsschlüssel in diesem Artikel wurden gekürzt, um die Lesbarkeit zu erhalten.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="http://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>

Die folgenden Elemente werden im SOAP-Anforderungstext verwendet:

Erfolgreiche Antwort des RemoveContactFromImList-Vorgangs

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine RemoveContactFromImList-Vorgangsanforderung zum Entfernen eines Kontakts aus der Lync-Kontaktliste .

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

Die folgenden Elemente werden im SOAP-Antworttext verwendet:

Fehlerantwort des RemoveContactFromImList-Vorgangs

Das folgende Beispiel zeigt eine Fehlerantwort auf eine RemoveContactFromImList-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung, einen Kontakt aus der Lync-Kontaktliste zu entfernen, wenn der Kontakt nicht mehr in der Liste vorhanden ist.

<?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="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">
      <RemoveContactFromImListResponse ResponseClass="Error" 
                                       xmlns="http://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>

Die folgenden Elemente werden im SOAP-Text der Fehlerantwort verwendet:

Siehe auch