Share via


Operación RemoveContactFromImList

Busque información sobre la operación EWS RemoveContactFromImList .

La operación RemoveContactFromImList quita los contactos de la lista de mensajería instantánea (MI) de Lync cuando Lync usa Exchange para el almacén de contactos.

Esta operación se introdujo en Exchange Server 2013.

Uso de la operación RemoveContactFromImList

La operación RemoveContactFromImList acepta un único argumento que identifica un contacto que se va a quitar de la lista de contactos de Lync almacenada en un servidor Exchange. La lista de contactos a los que se dirige esta operación se denomina Contactos de Lync en Outlook 2013.

Precaución

No use la operación DeleteItem para quitar contactos de una lista de contactos. Es posible que tenga que producirse un procesamiento adicional del lado servidor para admitir la eliminación de un contacto de la lista de contactos de Lync . Tenga en cuenta que la lista Contactos de Lync es el equivalente conceptual de la carpeta de buzón de contactos de Lync predeterminada.

Encabezados SOAP de la operación RemoveContactFromImList

La operación RemoveContactFromImList puede usar los encabezados SOAP que aparecen en la tabla siguiente.

Nombre de encabezado Elemento Descripción
Suplantación
ExchangeImpersonation
Identifica al usuario al que suplanta la aplicación cliente. Este encabezado es aplicable a una solicitud.
MailboxCulture
MailboxCulture
Identifica la referencia cultural, tal como se define en RFC 3066, "Etiquetas para la identificación de idiomas", que se usará para acceder al buzón. Este encabezado es aplicable a una solicitud.
RequestVersion
RequestServerVersion
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud.
ServerVersion
ServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta.

Ejemplo de solicitud de operación RemoveContactFromImList: quitar un contacto de la lista de contactos de Lync

En el ejemplo siguiente de una solicitud de operación RemoveContactFromImList se muestra cómo quitar un contacto de la lista de contactos de Lync . La operación RemoveContactFromImList acepta un único identificador de contacto para identificar el contacto que se quita de la lista de contactos de Lync .

Nota:

Todos los identificadores de elemento y las claves de cambio de este artículo se han acortado para conservar la legibilidad.

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

Los siguientes elementos se usan en el cuerpo soap de la solicitud:

Respuesta correcta de la operación RemoveContactFromImList

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación RemoveContactFromImList para quitar un contacto de la lista de contactos de 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="Success" 
                                       xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </RemoveContactFromImListResponse>
   </s:Body>
</s:Envelope>

Los siguientes elementos se usan en el cuerpo soap de la respuesta:

Respuesta de error de la operación RemoveContactFromImList

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación RemoveContactFromImList . Esta es una respuesta a una solicitud para quitar un contacto de la lista de contactos de Lync cuando el contacto ya no existe en la lista.

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

Los siguientes elementos se usan en el cuerpo SOAP de la respuesta de error:

Vea también