Операция GetUserPhoto

Статья
03/29/2023

Найдите сведения об операции GetUserPhoto EWS.

Операция GetUserPhoto получает фотографию пользователя из доменные службы Active Directory (AD DS).

Эта операция появилась в Exchange Server 2013.

Использование операции GetUserPhoto

Операция RemoveContactFromImList — это простая операция, которая принимает адрес электронной почты пользователя и запрошенный размер фотографии и возвращает фотопоток в ответе.

Примечание.

В EWS есть как операция SOAP, так и операция на основе REST для получения фотографий пользователей. Сведения об интерфейсе REST см. в статье Получение фотографий пользователей с помощью EWS в Exchange.

Заголовки SOAP операции GetUserPhoto

Операция GetUserPhoto может использовать заголовки SOAP, перечисленные в следующей таблице.

Имя заголовка	Элемент	Описание
RequestVersion	RequestServerVersion	Определяет версию схемы для запроса операции. Этот заголовок применим к запросу.
ServerVersion	ServerVersionInfo	Определяет версию сервера, который ответил на запрос. Этот заголовок применим к ответу.

Пример запроса на операцию GetUserPhoto: получение фотографии пользователя

В следующем примере запроса на операцию GetUserPhoto показано, как получить фотографию пользователя. В этом примере запрашивается фотография пользователя с разрешением 48x48 пикселей.

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

В тексте SOAP запроса используются следующие элементы:

Успешный ответ на операцию GetUserPhoto

В следующем примере показан успешный ответ на операцию GetUserPhoto для получения фотографии пользователя.

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

В тексте SOAP ответа используются следующие элементы:

Ответ на ошибку операции GetUserPhoto

Конверт SOAP не возвращает код ошибки, если предпринята попытка получить фотографию пользователя для адреса электронной почты, который не существует в организации. В ответе будет возвращен код состояния HTTP 500, указывающий на неудачу запроса.