Operación GetUserPhoto
Busque información sobre la operación EWS GetUserPhoto.
La operación GetUserPhoto obtiene una foto de usuario de Servicios de dominio de Active Directory (AD DS).
Esta operación se introdujo en Exchange Server 2013.
Uso de la operación GetUserPhoto
La operación RemoveContactFromImList es una operación sencilla que acepta la dirección de correo electrónico de un usuario y el tamaño de foto solicitado y devuelve la secuencia de fotos en la respuesta.
Nota
EWS tiene un SOAP y una operación basada en REST para obtener fotos de usuario. Para obtener información sobre la interfaz REST, vea Get user photos by using EWS in Exchange.
Encabezados SOAP de operación GetUserPhoto
La operación GetUserPhoto puede usar los encabezados SOAP que se enumeran en la tabla siguiente.
| Nombre de encabezado | Elemento | Descripción |
|---|---|---|
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema para la solicitud de operación. Este encabezado es aplicable a una solicitud. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. Este encabezado es aplicable a una respuesta. |
Ejemplo de solicitud de operación GetUserPhoto: Obtener la foto de un usuario
En el siguiente ejemplo de una solicitud de operación GetUserPhoto se muestra cómo obtener la foto de un usuario. En este ejemplo se solicita una foto de usuario de 48 x 48 píxeles.
<?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>
Los siguientes elementos se usan en el cuerpo SOAP de la solicitud:
Respuesta correcta de la operación GetUserPhoto
En el ejemplo siguiente se muestra una respuesta correcta a una operación GetUserPhoto para obtener la foto de un usuario.
<?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>
Los siguientes elementos se usan en el cuerpo SOAP de la respuesta:
Respuesta de error de operación GetUserPhoto
El sobre SOAP no devolverá un código de error si se intenta obtener una foto de usuario para una dirección de correo electrónico que no existe en la organización. Se devolverá un código de estado HTTP 500 en la respuesta para indicar que la solicitud no se ha hecho correctamente.