Operación SyncFolderItemsSyncFolderItems operation

La operación SyncFolderItems sincroniza los elementos entre el servidor de Exchange y el cliente.The SyncFolderItems operation synchronizes items between the Exchange server and the client.

ComentariosRemarks

La operación SyncFolderItems devolverá un máximo de 512 cambios.The SyncFolderItems operation will return a maximum of 512 changes. Las siguientes solicitudes de SyncFolderItems deben realizarse para obtener cambios adicionales.Subsequent SyncFolderItems requests must be performed to get additional changes.

SyncFolderItems es similar a la operación FindItem en que no puede devolver propiedades como Body o Attachments.SyncFolderItems is similar to the FindItem operation in that it cannot return properties like Body or Attachments. Si la operación SyncFolderItems no devuelve las propiedades que necesita, puede usar la operación GetItem para obtener un conjunto específico de propiedades para cada elemento devuelto por SyncFolderItems.If the SyncFolderItems operation does not return the properties that you need, you can use the GetItem operation to get a specific set of properties for each item that it returned by SyncFolderItems.

Ejemplo de solicitud SyncFolderItemsSyncFolderItems request example

DescriptionDescription

El siguiente ejemplo de una solicitud SyncFolderItems muestra cómo sincronizar elementos de una carpeta.The following example of a SyncFolderItems request shows how to synchronize items in a folder. En este ejemplo se muestra la sincronización de un elemento de carpeta que no es la primera sincronización que se ha producido para la carpeta elementos enviados.This example shows a folder item's synchronization that is not the first synchronization to have occurred for the Sent Items folder. El elemento SyncState no se incluye en la solicitud para el primer intento de sincronizar un cliente con el servidor Exchange.The SyncState element is not included in the request for the first attempt to synchronize a client with the Exchange server. El primer intento de sincronizar los elementos de una jerarquía de carpetas devolverá todos los elementos del buzón, excepto los elementos identificados en el elemento Ignore .The first attempt to synchronize the items in a folder hierarchy will return all the items in the mailbox, excluding items that are identified in the Ignore element. Esta solicitud de SyncFolderItems intentará sincronizar todos los cambios en los elementos de la carpeta desde la última sincronización.This SyncFolderItems request will try to synchronize all changes to the folder items since the last synchronization. Esta solicitud pasará por alto el intento de sincronizar el elemento identificado en el elemento Ignore .This request will ignore the attempt to synchronize the one item that is identified in the Ignore element.

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:Body>
    <SyncFolderItems xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ItemShape>
        <t:BaseShape>Default</t:BaseShape>
      </ItemShape>
      <SyncFolderId>
        <t:DistinguishedFolderId Id="sentitems"/>
      </SyncFolderId>
      <SyncState>AEbJ94eMOAAA=</SyncState>
      <Ignore>
        <t:ItemId Id="AQApAHRAA==" ChangeKey="CQAAABY"/>
      </Ignore>
      <MaxChangesReturned>100</MaxChangesReturned>
    </SyncFolderItems>
  </soap:Body>
</soap:Envelope>

ComentariosComments

Los datos codificados en base64 del elemento SyncState y el atributo ID del elemento Itemid se han abreviado para preservar la legibilidad.The SyncState element base64-encoded data and the ItemId element Id attribute have been shortened to preserve readability.

Elementos de solicitudRequest elements

Los siguientes elementos se usan en la solicitud:The following elements are used in the request:

Respuesta SyncFolderItems correctaSuccessful SyncFolderItems Response

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta correcta a la solicitud SyncFolderItems.The following example shows a successful response to the SyncFolderItems request. En este ejemplo, se sincroniza una convocatoria de reunión desde la carpeta elementos enviados.In this example, a meeting request is synchronized from the Sent Items folder.

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="0" 
                         MajorBuildNumber="628" MinorBuildNumber="0" 
      xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <SyncFolderItemsResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                             xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:SyncFolderItemsResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:SyncState>H4sIAAAAA=</m:SyncState>
          <m:IncludesLastItemInRange>true</m:IncludesLastItemInRange>
          <m:Changes>
            <t:Create>
              <t:MeetingRequest>
                <t:ItemId Id="AQApAHRwA==" ChangeKey="CwAAABYA" />
                <t:Subject>Budget Q3</t:Subject>
                <t:Sensitivity>Normal</t:Sensitivity>
                <t:IsOutOfDate>false</t:IsOutOfDate>
                <t:HasBeenProcessed>true</t:HasBeenProcessed>
                <t:ResponseType>NoResponseReceived</t:ResponseType>
                <t:IntendedFreeBusyStatus>Busy</t:IntendedFreeBusyStatus>
                <t:Start>2006-08-02T17:30:00Z</t:Start>
                <t:End>2006-08-02T19:30:00Z</t:End>
                <t:Location>Conference Room 2</t:Location>
                <t:Organizer>
                  <t:Mailbox>
                    <t:Name>Dan Park</t:Name>
                    <t:EmailAddress>dpark@example.com</t:EmailAddress>
                    <t:RoutingType>SMTP</t:RoutingType>
                  </t:Mailbox>
                </t:Organizer>
              </t:MeetingRequest>
            </t:Create>
          </m:Changes>
        </m:SyncFolderItemsResponseMessage>
      </m:ResponseMessages>
    </SyncFolderItemsResponse>
  </soap:Body>
</soap:Envelope>

ComentariosComments

Los datos codificados en base64 del elemento SyncState y el atributo ID del elemento Itemid se han abreviado para preservar la legibilidad.The SyncState element base64-encoded data and the ItemId element Id attribute have been shortened to preserve readability.

Elementos Response correctoSuccessful response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Respuesta de error de SyncFolderItemsSyncFolderItems error response

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta de error a una solicitud SyncFolderItems.The following example shows an error response to a SyncFolderItems request. Este error se debió a un SyncState no válido.This error was caused by an invalid SyncState.

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="0" 
                         MajorBuildNumber="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <SyncFolderItemsResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                             xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:SyncFolderItemsResponseMessage ResponseClass="Error">
          <m:MessageText>Synchronization state data is corrupt or otherwise invalid.</m:MessageText>
          <m:ResponseCode>ErrorInvalidSyncStateData</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:SyncState />
          <m:IncludesLastItemInRange>true</m:IncludesLastItemInRange>
        </m:SyncFolderItemsResponseMessage>
      </m:ResponseMessages>
    </SyncFolderItemsResponse>
  </soap:Body>
</soap:Envelope>

Elementos de respuesta de errorError response elements

Los siguientes elementos se usan en la respuesta de error:The following elements are used in the error response:

Vea tambiénSee also