UpdateDelegate operation
The UpdateDelegate operation updates delegate permissions on a principal's mailbox.
SOAP Headers
The UpdateDelegate operation can use the SOAP headers that are listed and described in the following table.
Header | Element | Description |
---|---|---|
Impersonation |
ExchangeImpersonation |
Identifies the user whom the client application is impersonating. |
MailboxCulture |
MailboxCulture |
Identifies the RFC3066 culture to be used to access the mailbox. |
RequestVersion |
RequestServerVersion |
Identifies the schema version for the operation request. |
ServerVersion |
ServerVersionInfo |
Identifies the version of the server that responded to the request. |
UpdateDelegate request example
Description
The following example of an UpdateDelegate request shows you how to update delegate permissions on user1's account. User2 is granted the None permission level for the Tasks folder and is granted permission to view private items. User3 is granted Reviewer permissions for the Journal folder. Meeting requests are sent to the delegates, and information about the request is sent to User1.
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>
<UpdateDelegate xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<Mailbox>
<t:EmailAddress>user1@example.com</t:EmailAddress>
</Mailbox>
<DelegateUsers>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>user2@example.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
</t:DelegatePermissions>
<t:ViewPrivateItems>true</t:ViewPrivateItems>
</t:DelegateUser>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>user3@example.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:JournalFolderPermissionLevel>Reviewer</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
</t:DelegateUser>
</DelegateUsers>
<DeliverMeetingRequests>DelegatesAndSendInformationToMe</DeliverMeetingRequests>
</UpdateDelegate>
</soap:Body>
</soap:Envelope>
Comments
The UpdateDelegate request does not require that updates be applied to delegates. Clients can change only the DeliverMeetingMessage setting.
UpdateDelegate response example
Description
The following example shows a successful response to an UpdateDelegate operation.
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:UpdateDelegateResponse 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-1117</t:SID>
<t:PrimarySmtpAddress>User2@example.com</t:PrimarySmtpAddress>
<t:DisplayName>User2</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>true</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>true</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1333220396-2200287332-232816053-1118</t:SID>
<t:PrimarySmtpAddress>User3@example.com</t:PrimarySmtpAddress>
<t:DisplayName>User3</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>true</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:UpdateDelegateResponse>
</soap:Body>
</soap:Envelope>
UpdateDelegate Error response example
Description
The following example shows an error response to an UpdateDelegate request. The error was generated because the delegate does not exist in the principal's delegate list.
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:UpdateDelegateResponse 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="Error">
<m:MessageText>The user is not a delegate for the mailbox.</m:MessageText>
<m:ResponseCode>ErrorNotDelegate</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:UpdateDelegateResponse>
</soap:Body>
</soap:Envelope>
See also
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기