Operación UpdateDelegate
La operación UpdateDelegate actualiza los permisos delegados en el buzón de una entidad de seguridad.
Encabezados SOAP
La operación UpdateDelegate puede usar los encabezados SOAP que se enumeran y describen en la tabla siguiente.
| Header | Elemento | Descripción |
|---|---|---|
| Suplantación |
ExchangeImpersonation |
Identifica al usuario al que suplanta la aplicación cliente. |
| MailboxCulture |
MailboxCulture |
Identifica la referencia cultural RFC3066 que se va a usar para acceder al buzón. |
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. |
Ejemplo de solicitud UpdateDelegate
Descripción
En el ejemplo siguiente de una solicitud UpdateDelegate se muestra cómo actualizar los permisos delegados en la cuenta del usuario1. A User2 se le concede el nivel de permiso Ninguno para la carpeta Tareas y se le concede permiso para ver elementos privados. A User3 se le conceden permisos de revisor para la carpeta Journal. Las solicitudes de reunión se envían a los delegados y la información sobre la solicitud se envía a User1.
Código
<?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>
Comentarios
La solicitud UpdateDelegate no requiere que las actualizaciones se apliquen a los delegados. Los clientes solo pueden cambiar la configuración DeliverMeetingMessage .
Ejemplo de respuesta updateDelegate
Descripción
En el ejemplo siguiente se muestra una respuesta correcta a una operación UpdateDelegate .
Código
<?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>
Ejemplo de respuesta de error updateDelegate
Descripción
En el ejemplo siguiente se muestra una respuesta de error a una solicitud UpdateDelegate . El error se generó porque el delegado no existe en la lista de delegados de la entidad de seguridad.
Código
<?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>