Operação GetDelegate

  • Artigo

A operação GetDelegate recupera as configurações do delegado para uma caixa de correio especificada.

Cabeçalhos SOAP

A operação GetDelegate 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 GetDelegate

Descrição

O exemplo de código a seguir mostra como recuperar as configurações de delegado para todos os delegados definidos na caixa de correio do user3. Todas as permissões para cada usuário são retornadas na resposta.

Código

<?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>
    <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

Você pode usar o elemento UserId para especificar usuários individuais em vez de retornar todos os usuários que têm permissões de acesso delegado na caixa de correio.

Observação

O EWS (Exchange Web Services) não dá suporte ao gerenciamento de delegados do grupo. O EWS retornará um erro se a operação GetDelegate for chamada para uma entidade de segurança que tenha um delegado de grupo de segurança.

Exemplo de resposta GetDelegate

Descrição

O exemplo a seguir de uma resposta GetDelegate mostra uma resposta bem-sucedida a uma solicitação GetDelegate . A resposta contém informações sobre as permissões de acesso do delegado, se o delegado pode exibir itens privados, se o delegado recebe cópias de mensagens de reunião e a quem as solicitações de reunião foram entregues.

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="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>

Confira também