Opération GetDelegate

  • Article

L’opération GetDelegate récupère les paramètres délégués d’une boîte aux lettres spécifiée.

En-têtes SOAP

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

Header Élément Description
Emprunt d’identité
 ExchangeImpersonation
Identifie l’utilisateur que l’application cliente emprunte l’identité.
MailboxCulture
 MailboxCulture
Identifie la culture RFC3066 à utiliser pour accéder à la boîte aux lettres.
RequestVersion
 RequestServerVersion
Identifie la version du schéma pour la demande d’opération.
ServerVersion
 ServerVersionInfo
Identifie la version du serveur qui a répondu à la requête.

Exemple de requête GetDelegate

Description

L’exemple de code suivant montre comment récupérer les paramètres de délégué pour tous les délégués définis sur la boîte aux lettres de user3. Toutes les autorisations pour chaque utilisateur sont retournées dans la réponse.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2007_SP1"/>
  </soap:Header>
  <soap:Body>
    <GetDelegate xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
                 IncludePermissions="true">
      <Mailbox>
        <t:EmailAddress>user3@example.com</t:EmailAddress>
      </Mailbox>
    </GetDelegate>
  </soap:Body>
</soap:Envelope>

Comments

Vous pouvez utiliser l’élément UserId pour spécifier des utilisateurs individuels au lieu de renvoyer tous les utilisateurs disposant d’autorisations d’accès délégué sur la boîte aux lettres.

Remarque

Les services Web Exchange (EWS) ne prennent pas en charge la gestion des délégués de groupe. EWS retourne une erreur si l’opération GetDelegate est appelée pour un principal qui a un délégué de groupe de sécurité.

Exemple de réponse GetDelegate

Description

L’exemple suivant de réponse GetDelegate montre une réponse réussie à une requête GetDelegate . La réponse contient des informations sur les autorisations d’accès délégué, si le délégué peut afficher les éléments privés, si le délégué reçoit des copies des messages de réunion et à qui les demandes de réunion ont été remises.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" 
                         MinorVersion="1" 
                         MajorBuildNumber="206" 
                         MinorBuildNumber="0" 
                         Version="Exchange2007_SP1" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <m:GetDelegateResponse xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                           ResponseClass="Success" 
                           xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseCode>NoError</m:ResponseCode>
      <m:ResponseMessages>
        <m:DelegateUserResponseMessageType ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:DelegateUser>
              <t:UserId>
                <t:SID>S-1-5-21-1333220396-2200287332-232816053-1116</t:SID>
                <t:PrimarySmtpAddress>User1@example.com</t:PrimarySmtpAddress>
                <t:DisplayName>User1</t:DisplayName>
              </t:UserId>
              <t:DelegatePermissions>
                <t:CalendarFolderPermissionLevel>Author</t:CalendarFolderPermissionLevel>
                <t:ContactsFolderPermissionLevel>Reviewer</t:ContactsFolderPermissionLevel>
              </t:DelegatePermissions>
              <t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
            <t:ViewPrivateItems>false</t:ViewPrivateItems>
            </m:DelegateUser>
          </m:DelegateUserResponseMessageType>
      </m:ResponseMessages>
      <m:DeliverMeetingRequests>DelegatesAndMe</m:DeliverMeetingRequests>
      </m:GetDelegateResponse>
  </soap:Body>
</soap:Envelope>

Voir aussi