Операция UpdateDelegate
Операция UpdateDelegate обновляет разрешения на почтовый ящик субъекта.
Заголовки SOAP
Операция UpdateDelegate может использовать заголовки SOAP, перечисленные и описанные в следующей таблице.
Header | Элемент | Описание |
---|---|---|
Олицетворение |
ExchangeImpersonation |
Определяет пользователя, которого олицетворяет клиентское приложение. |
MailboxCulture |
MailboxCulture |
Определяет язык и региональные параметры RFC3066, используемые для доступа к почтовому ящику. |
RequestVersion |
RequestServerVersion |
Определяет версию схемы для запроса операции. |
ServerVersion |
ServerVersionInfo |
Определяет версию сервера, который ответил на запрос. |
Пример запроса UpdateDelegate
Описание
В следующем примере запроса UpdateDelegate показано, как обновить разрешения делегата для учетной записи user1. Пользователю 2 предоставляется уровень разрешений None для папки "Задачи" и разрешение на просмотр закрытых элементов. Пользователю 3 предоставлены разрешения рецензента для папки Журнал. Приглашения на собрание отправляются делегатам, а сведения о запросе — пользователю User1.
Код
<?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>
<UpdateDelegate xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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
Запрос UpdateDelegate не требует применения обновлений к делегатам. Клиенты могут изменять только параметр DeliverMeetingMessage .
Пример ответа UpdateDelegate
Описание
В следующем примере показан успешный ответ на операцию UpdateDelegate .
Код
<?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:UpdateDelegateResponse 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-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
Описание
В следующем примере показан ответ на ошибку на запрос UpdateDelegate . Ошибка была вызвана тем, что делегат не существует в списке делегатов субъекта.
Код
<?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:UpdateDelegateResponse 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="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>