Compartilhar via

Operação RemoveContactFromImList

  • Artigo

Encontre informações sobre a operação EWS RemoveContactFromImList .

A operação RemoveContactFromImList remove contatos da lista IM (mensagens instantâneas) do Lync quando o Lync usa o Exchange para o repositório de contatos.

This operation was introduced in Exchange Server 2013.

Usando a operação RemoveContactFromImList

A operação RemoveContactFromImList aceita um único argumento que identifica um contato para remover da lista de contatos do Lync armazenada em um servidor exchange. A lista de contatos que essa operação visa é chamada de Contatos do Lync no Outlook 2013.

Cuidado

Não use a operação DeleteItem para remover contatos de uma lista de contatos. O processamento adicional do lado do servidor pode ter que ocorrer para dar suporte à remoção de um contato da lista Contatos do Lync . Observe que a lista Contatos do Lync é o equivalente conceitual da pasta de caixa de correio padrão Contatos do Lync .

Cabeçalhos SOAP da operação RemoveContactFromImList

A operação RemoveContactFromImList pode usar os cabeçalhos SOAP listados na tabela a seguir.

Nome de cabeçalho Elemento Descrição
Representação
ExchangeImpersonation
Identifica o usuário que o aplicativo cliente está representando. Esse cabeçalho é aplicável a uma solicitação.
MailboxCulture
MailboxCulture
Identifica a cultura, conforme definido no RFC 3066, "Marcas para a Identificação de Idiomas", a ser usada para acessar a caixa de correio. Esse cabeçalho é aplicável a uma solicitação.
RequestVersion
RequestServerVersion
Identifica a versão do esquema para a solicitação de operação. Esse cabeçalho é aplicável a uma solicitação.
Serverversion
ServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação. Esse cabeçalho é aplicável a uma resposta.

Exemplo de solicitação de operação RemoveContactFromImList: remover um contato da lista Contatos do Lync

O exemplo a seguir de uma solicitação de operação RemoveContactFromImList mostra como remover um contato da lista Contatos do Lync . A operação RemoveContactFromImList aceita um único identificador de contato exclusivo para identificar o contato removido da lista Contatos do Lync .

Observação

Todos os identificadores de item e chaves de alteração neste artigo foram encurtados para preservar a legibilidade.

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

Os seguintes elementos são usados no corpo SOAP de solicitação:

Resposta bem-sucedida da operação RemoveContactFromImList

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação RemoveContactFromImList para remover um contato da lista Contatos do 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="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>

Os seguintes elementos são usados no corpo soap de resposta:

Resposta de erro de operação RemoveContactFromImList

O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação RemoveContactFromImList . Essa é uma resposta a uma solicitação para remover um contato da lista Contatos do Lync quando o contato não existe mais na 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="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>

Os seguintes elementos são usados no corpo soap de resposta de erro:

Confira também