Opération GetUserPhoto

  • Article

Recherchez des informations sur l’opération EWS GetUserPhoto .

L’opération GetUserPhoto obtient une photo de l’utilisateur à partir de services de domaine Active Directory (AD DS).

Cette opération est une nouveauté d’Exchange Server 2013.

Utilisation de l’opération GetUserPhoto

L’opération RemoveContactFromImList est une opération simple qui accepte l’adresse e-mail d’un utilisateur et la taille de photo demandée, et retourne le flux de photos dans la réponse.

Remarque

EWS dispose à la fois d’une opération SOAP et d’une opération BASÉE sur REST pour obtenir des photos des utilisateurs. Pour plus d’informations sur l’interface REST, consultez Obtenir des photos utilisateur à l’aide d’EWS dans Exchange.

En-têtes SOAP de l’opération GetUserPhoto

L’opération GetUserPhoto peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.

Nom de l'en-tête Élément Description
RequestVersion
RequestServerVersion
Identifie la version du schéma pour la demande d’opération. Cet en-tête s’applique à une requête.
ServerVersion
ServerVersionInfo
Identifie la version du serveur qui a répondu à la requête. Cet en-tête s’applique à une réponse.

Exemple de demande d’opération GetUserPhoto : Obtenir la photo d’un utilisateur

L’exemple suivant de demande d’opération GetUserPhoto montre comment obtenir la photo d’un utilisateur. Cet exemple demande une photo d’utilisateur de 48 x 48 pixels.

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

Les éléments suivants sont utilisés dans le corps SOAP de la demande :

Réponse de l’opération GetUserPhoto réussie

L’exemple suivant montre une réponse réussie à une opération GetUserPhoto pour obtenir la photo d’un utilisateur.

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

Les éléments suivants sont utilisés dans le corps SOAP de la réponse :

Réponse d’erreur d’opération GetUserPhoto

L’enveloppe SOAP ne retourne pas de code d’erreur si une tentative d’obtention d’une photo d’utilisateur pour une adresse e-mail qui n’existe pas dans l’organisation est effectuée. Un code d’état HTTP 500 est retourné dans la réponse pour indiquer que la requête a échoué.

Voir aussi