Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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="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>
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="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>
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.