Operação AddDelegate
A operação AddDelegate adiciona um ou mais delegados à caixa de correio de uma entidade de correio e define permissões de acesso específicas.
Cabeçalhos SOAP
A operação AddDelegate pode usar os cabeçalhos SOAP listados e descritos na tabela a seguir.
Header | Elemento | Descrição |
---|---|---|
Representação |
ExchangeImpersonation |
Identifica o usuário que o aplicativo cliente está representando. |
MailboxCulture |
MailboxCulture |
Identifica a cultura RFC3066 a ser usada para acessar a caixa de correio. |
RequestVersion |
RequestServerVersion |
Identifica a versão do esquema para a solicitação de operação. |
Serverversion |
ServerVersionInfo |
Identifica a versão do servidor que respondeu à solicitação. |
Exemplo de solicitação AddDelegate
Descrição
O exemplo a seguir de uma solicitação AddDelegate mostra uma tentativa de dar permissões de delegado user1 em pastas que pertencem ao user2. O User1 recebe permissões no nível do autor para a pasta Calendário do user2 e permissões no nível do Revisor para a pasta Contatos do usuário2. User1 não receberá cópias de mensagens de reunião e não poderá exibir itens privados na caixa de correio do user2. As solicitações de reunião serão enviadas para user1 e user2.
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 xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<AddDelegate>
<Mailbox>
<t:EmailAddress>user2@example.com</t:EmailAddress>
</Mailbox>
<DelegateUsers>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>user1@example.com</t:PrimarySmtpAddress>
</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>
</t:DelegateUser>
</DelegateUsers>
<DeliverMeetingRequests>DelegatesAndMe</DeliverMeetingRequests>
</AddDelegate>
</soap:Body>
</soap:Envelope>
Exemplo de resposta AddDelegate
Descrição
O exemplo a seguir de uma resposta AddDelegate mostra uma resposta bem-sucedida a uma solicitação AddDelegate .
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:AddDelegateResponse 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:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:AddDelegateResponse>
</soap:Body>
</soap:Envelope>
Exemplo de resposta de erro addDelegate
Descrição
O exemplo a seguir mostra a resposta a uma solicitação para adicionar um delegado que já foi adicionado à caixa de correio da entidade de correio.
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:AddDelegateResponse 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 already a delegate for the mailbox.</m:MessageText>
<m:ResponseCode>ErrorDelegateAlreadyExists</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:AddDelegateResponse>
</soap:Body>
</soap:Envelope>
Comments
Se o código de resposta ErrorDelegateAlreadyExists for retornado quando você tentar adicionar um delegado, use a operação GetDelegate para obter todas as permissões atuais para o delegado e use a operação UpdateDelegate para definir as novas permissões.