GetUserPhoto-Vorgang

Artikel
03/29/2023

Hier finden Sie Informationen zum EWS-Vorgang GetUserPhoto .

Der GetUserPhoto-Vorgang ruft ein Benutzerfoto aus Active Directory Domain Services (AD DS) ab.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des GetUserPhoto-Vorgangs

Der RemoveContactFromImList-Vorgang ist ein einfacher Vorgang, der die E-Mail-Adresse eines Benutzers und die angeforderte Fotogröße akzeptiert und den Fotostream in der Antwort zurückgibt.

Hinweis

EWS verfügt sowohl über einen SOAP- als auch über einen REST-basierten Vorgang zum Abrufen von Benutzerfotos. Informationen zur REST-Schnittstelle finden Sie unter Abrufen von Benutzerfotos mithilfe von EWS in Exchange.

SOAP-Header des GetUserPhoto-Vorgangs

Der GetUserPhoto-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.

Headername	Element	Beschreibung
RequestVersion	RequestServerVersion	Gibt die Schemaversion für die Vorgangsanforderung an. Dieser Header gilt für eine Anforderung.
ServerVersion	ServerVersionInfo	Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dieser Header gilt für eine Antwort.

GetUserPhoto-Vorgangsanforderungsbeispiel: Abrufen des Fotos eines Benutzers

Das folgende Beispiel für eine GetUserPhoto-Vorgangsanforderung zeigt, wie das Foto eines Benutzers abgerufen wird. In diesem Beispiel wird ein Benutzerfoto mit einer Größe von 48 x 48 Pixeln angefordert.

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

Die folgenden Elemente werden im SOAP-Anforderungstext verwendet:

Erfolgreiche GetUserPhoto-Vorgangsantwort

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf einen GetUserPhoto-Vorgang zum Abrufen des Fotos eines Benutzers.

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

Die folgenden Elemente werden im SOAP-Antworttext verwendet:

GetUserPhoto-Vorgangsfehlerantwort

Der SOAP-Umschlag gibt keinen Fehlercode zurück, wenn versucht wird, ein Benutzerfoto für eine E-Mail-Adresse abzurufen, die in der Organisation nicht vorhanden ist. Der HTTP-Statuscode 500 wird in der Antwort zurückgegeben, um anzugeben, dass die Anforderung nicht erfolgreich war.

Share via