Operação GetUserPhoto

Artigo
03/29/2023

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

A operação GetUserPhoto obtém uma foto do usuário do Active Directory Domain Services (AD DS).

This operation was introduced in Exchange Server 2013.

Usando a operação GetUserPhoto

A operação RemoveContactFromImList é uma operação simples que aceita o endereço de email de um usuário e o tamanho da foto solicitado e retorna o fluxo de fotos na resposta.

Observação

O EWS tem uma operação baseada em SOAP e REST para obter fotos do usuário. Para obter informações sobre a interface REST, consulte Obter fotos do usuário usando o EWS no Exchange.

Cabeçalhos SOAP da operação GetUserPhoto

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

Nome de cabeçalho	Elemento	Descriçã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 GetUserPhoto: obter uma foto do usuário

O exemplo a seguir de uma solicitação de operação GetUserPhoto mostra como obter a foto de um usuário. Este exemplo solicita uma foto de usuário de 48x48 pixels.

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

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

Resposta bem-sucedida da operação GetUserPhoto

O exemplo a seguir mostra uma resposta bem-sucedida a uma operação GetUserPhoto para obter a foto de um usuário.

<?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">
      <GetUserPhotoResponse ResponseClass="Success" 
                            xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
         <HasChanged>true</HasChanged>
         <PictureData>/9j/4AAQSkZJRgABAQEAYABgAAD/02</PictureData>
      </GetUserPhotoResponse>
   </s:Body>
</s:Envelope>

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

Resposta de erro da operação GetUserPhoto

O envelope SOAP não retornará um código de erro se for feita uma tentativa de obter uma foto do usuário para um endereço de email que não existe na organização. Um código de status HTTP 500 será retornado na resposta para indicar que a solicitação não foi bem-sucedida.