Partager via

Opération RemoveImContactFromGroup

  • Article

Recherchez des informations sur l’opération EWS RemoveImContactFromGroup .

L’opération RemoveImContactFromGroup supprime un seul contact de messagerie instantanée d’un groupe de messagerie instantanée.

Cette opération est une nouveauté d’Exchange Server 2013.

Utilisation de l’opération RemoveImContactFromGroup

L’opération RemoveImContactFromGroup prend deux arguments : un identificateur d’élément de contact et le groupe de messagerie instantanée correspondant à partir duquel le contact est supprimé.

En-têtes SOAP de l’opération RemoveImContactFromGroup

L’opération RemoveImContactFromGroup peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.

Nom de l'en-tête Élément Description
Imitation
ExchangeImpersonation
Identifie l’utilisateur que l’application cliente emprunte l’identité. Cet en-tête s’applique à une requête.
MailboxCulture
MailboxCulture
Identifie la culture, telle que définie dans la RFC 3066, « Balises pour l’identification des langues », à utiliser pour accéder à la boîte aux lettres. Cet en-tête s’applique à une requête.
RequestVersion
RequestServerVersion
Identifie la version du schéma pour la demande d’opération. Cet en-tête s’applique à une requête.
ServerVersion
ServerVersionInfo
Identifie la version du serveur qui a répondu à la requête. Cet en-tête s’applique à une réponse.

Exemple de demande d’opération RemoveImContactFromGroup

L’exemple suivant de demande d’opération RemoveImContactFromGroup montre comment supprimer un contact de messagerie instantanée d’un groupe de messagerie instantanée.

Remarque

Les identificateurs de groupe et de contact ont été raccourcis pour préserver la lisibilité.

<?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>

Le corps SOAP de la demande contient les éléments suivants :

Réponse de l’opération RemoveImContactFromGroup réussie

L’exemple suivant montre une réponse réussie à une demande d’opération 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>

Le corps SOAP de la réponse contient les éléments suivants :

Réponse d’erreur de l’opération RemoveImContactFromGroup ErrorInvalidImContactId

L’exemple suivant montre une réponse d’erreur à une demande d’opération RemoveImContactFromGroup . La réponse d’erreur suivante se produit lorsqu’une tentative de suppression d’un élément de contact qui n’existe pas dans le groupe de messagerie instantanée est effectuée.

<?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>

Le corps SOAP de la réponse contient les éléments suivants :

Voir aussi