Operación AddDelegateAddDelegate operation

La operación AddDelegate agrega uno o más delegados al buzón de una entidad de identidad y establece permisos de acceso específicos.The AddDelegate operation adds one or more delegates to a principal's mailbox and sets specific access permissions.

Encabezados SOAPSOAP headers

La operación AddDelegate puede usar los encabezados SOAP que se enumeran y describen en la siguiente tabla.The AddDelegate operation can use the SOAP headers that are listed and described in the following table.

HeaderHeader ElementoElement DescripciónDescription
SuplantaciónImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica al usuario que está suplantando la aplicación cliente.Identifies the user whom the client application is impersonating.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica la referencia cultural RFC3066 que se va a usar para obtener acceso al buzón.Identifies the RFC3066 culture to be used to access the mailbox.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica la versión del esquema para la solicitud de operación.Identifies the schema version for the operation request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.Identifies the version of the server that responded to the request.

Ejemplo de solicitud AddDelegateAddDelegate request example

DescriptionDescription

El siguiente ejemplo de una solicitud AddDelegate muestra un intento de conceder a user1 permisos delegar en carpetas que son propiedad del usuario2.The following example of an AddDelegate request shows an attempt to give user1 delegate permissions on folders that are owned by user2. User1 tiene permisos de autor para user2's la carpeta calendario y los permisos de nivel de revisor en la carpeta contactos de user2's.User1 is given Author-level permissions to user2's Calendar folder and Reviewer-level permissions to user2's Contacts folder. User1 no recibirá copias de los mensajes de reunión y no podrá ver los elementos privados en el buzón de user2's.User1 will not receive copies of meeting messages and will be unable to view private items in user2's mailbox. Las convocatorias de reunión se enviarán tanto a user1 como a usuario2.Meeting requests will be sent to both user1 and user2.

CódigoCode

<?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 xmlns="https://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>

Ejemplo de respuesta AddDelegateAddDelegate response example

DescriptionDescription

El siguiente ejemplo de una respuesta de AddDelegate muestra una respuesta correcta a una solicitud de AddDelegate .The following example of an AddDelegate response shows a successful response to an AddDelegate request.

CódigoCode

<?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:AddDelegateResponse 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:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
            <t:ViewPrivateItems>false</t:ViewPrivateItems>
            </m:DelegateUser>
        </m:DelegateUserResponseMessageType>
      </m:ResponseMessages>
    </m:AddDelegateResponse>
  </soap:Body>
</soap:Envelope>

Ejemplo de respuesta de error AddDelegateAddDelegate error response example

DescriptionDescription

En el ejemplo siguiente se muestra la respuesta a una solicitud para agregar un delegado que ya se ha agregado al buzón de la entidad de la identidad.The following example shows the response to a request to add a delegate who has already been added to the principal's mailbox.

CódigoCode

<?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:AddDelegateResponse 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="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>

ComentariosComments

Si se devuelve el código de respuesta ErrorDelegateAlreadyExists al intentar agregar un delegado, use la operación GetDelegate para obtener todos los permisos actuales para el delegado y, a continuación, use la operación UpdateDelegate para establecer los nuevos permisos.If the ErrorDelegateAlreadyExists response code is returned when you try to add a delegate, use the GetDelegate operation to get all the current permissions for the delegate, and then use the UpdateDelegate operation to set the new permissions.

Vea tambiénSee also