GetUserPhoto 操作

项目
03/29/2023

查找有关 GetUserPhoto EWS 操作的信息。

GetUserPhoto 操作从 Active Directory 域服务 (AD DS) 获取用户照片。

Exchange Server 2013 中引入了此操作。

使用 GetUserPhoto 操作

RemoveContactFromImList 操作是一个简单的操作，它接受用户的电子邮件地址和请求的照片大小，并在响应中返回照片流。

注意

EWS 具有基于 SOAP 和 REST 的操作，用于获取用户照片。有关 REST 界面的信息，请参阅在 Exchange 中使用 EWS 获取用户照片。

GetUserPhoto 操作 SOAP 标头

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="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="http://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="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">
      <GetUserPhotoResponse ResponseClass="Success" 
                            xmlns="http://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 信封不会返回错误代码。响应中将返回 500 HTTP 状态代码，以指示请求失败。

通过