GetDelegate Operation
Last modified: September 26, 2011
Applies to: Exchange Server 2007 | Exchange Server 2010
In this article
SOAP Headers
GetDelegate Request Example
GetDelegate Response Example
The GetDelegate operation retrieves the delegate settings for a specified mailbox.
SOAP Headers
The GetDelegate operation can use the SOAP headers that are listed and described in the following table.
Header |
Element |
Description |
|---|---|---|
Impersonation |
Identifies the user whom the client application is impersonating. |
|
MailboxCulture |
Identifies the RFC3066 culture to be used to access the mailbox. |
|
RequestVersion |
Identifies the schema version for the operation request. |
|
ServerVersion |
Identifies the version of the server that responded to the request. |
GetDelegate Request Example
Description
The following code example shows how to retrieve the delegate settings for all the delegates that are set on user3's mailbox. All the permissions for each user are returned in the response.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://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
You can use the UserId element to specify individual users instead of returning all users who have delegate access permissions on the mailbox.
Note
Exchange Web Services (EWS) does not support managing group delegates. EWS will return an error if the GetDelegate operation is called for a principal that has a security group delegate.
GetDelegate Response Example
Description
The following example of a GetDelegate response shows a successful response to a GetDelegate request. The response contains information about the delegate access permissions, whether the delegate can view private items, whether the delegate receives copies of meeting messages, and to whom meeting requests were delivered.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://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>