Operación GetDelegate

  • Artículo

La operación GetDelegate recupera la configuración de delegado de un buzón especificado.

Encabezados SOAP

La operación GetDelegate 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 GetDelegate

Descripción

En el ejemplo de código siguiente se muestra cómo recuperar la configuración de delegado para todos los delegados que se establecen en el buzón de user3. Todos los permisos para cada usuario se devuelven en la respuesta.

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>

Comentarios

Puede usar el elemento UserId para especificar usuarios individuales en lugar de devolver todos los usuarios que tengan permisos de acceso delegados en el buzón.

Nota:

Exchange Web Services (EWS) no admite la administración de delegados de grupo. EWS devolverá un error si se llama a la operación GetDelegate para una entidad de seguridad que tiene un delegado de grupo de seguridad.

Ejemplo de respuesta getDelegate

Descripción

En el ejemplo siguiente de una respuesta GetDelegate se muestra una respuesta correcta a una solicitud GetDelegate . La respuesta contiene información sobre los permisos de acceso de delegado, si el delegado puede ver elementos privados, si el delegado recibe copias de mensajes de reunión y a quién se entregaron las solicitudes de reunión.

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>

Vea también