Opération GetDelegate
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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1"/>
</soap:Header>
<soap:Body>
<GetDelegate xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<m:GetDelegateResponse xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
ResponseClass="Success"
xmlns:m="http://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>