GetUserPhoto 操作

查找有关 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 状态代码,以指示请求失败。

另请参阅