Operação SyncFolderItemsSyncFolderItems operation

A operação SyncFolderItems sincroniza itens entre o servidor Exchange e o cliente.The SyncFolderItems operation synchronizes items between the Exchange server and the client.

ComentáriosRemarks

A operação SyncFolderItems retornará um máximo de 512 alterações.The SyncFolderItems operation will return a maximum of 512 changes. As solicitações SyncFolderItems subsequentes devem ser executadas para obter alterações adicionais.Subsequent SyncFolderItems requests must be performed to get additional changes.

SyncFolderItems é semelhante à operação FindItem, pois não é possível retornar propriedades como Body ou Attachments.SyncFolderItems is similar to the FindItem operation in that it cannot return properties like Body or Attachments. Se a operação SyncFolderItems não retornar as propriedades que você precisa, você pode usar a operação GetItem para obter um conjunto específico de propriedades para cada item retornado 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.

Exemplo de solicitação SyncFolderItemsSyncFolderItems request example

DescriçãoDescription

O exemplo a seguir de uma solicitação SyncFolderItems mostra como sincronizar itens em uma pasta.The following example of a SyncFolderItems request shows how to synchronize items in a folder. Este exemplo mostra uma sincronização de item de pasta que não é a primeira sincronização que ocorreu para a pasta Itens enviados.This example shows a folder item's synchronization that is not the first synchronization to have occurred for the Sent Items folder. O elemento SyncState não está incluído na solicitação para a primeira tentativa de sincronizar um cliente com o Exchange Server.The SyncState element is not included in the request for the first attempt to synchronize a client with the Exchange server. A primeira tentativa de sincronizar os itens em uma hierarquia de pastas retornará todos os itens da caixa de correio, excluindo os itens identificados no 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. Essa solicitação de SyncFolderItems tentará sincronizar todas as alterações feitas nos itens de pasta desde a última sincronização.This SyncFolderItems request will try to synchronize all changes to the folder items since the last synchronization. Essa solicitação ignorará a tentativa de sincronização de um item identificado no 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>

ComentáriosComments

O elemento SyncState dados codificados em Base64 e o atributo ID do elemento ItemId foram reduzidos para preservar a legibilidade.The SyncState element base64-encoded data and the ItemId element Id attribute have been shortened to preserve readability.

Elementos RequestRequest elements

Os seguintes elementos são usados na solicitação:The following elements are used in the request:

Resposta SyncFolderItems bem-sucedidaSuccessful SyncFolderItems Response

DescriçãoDescription

O exemplo a seguir mostra uma resposta bem-sucedida à solicitação SyncFolderItems.The following example shows a successful response to the SyncFolderItems request. Neste exemplo, uma solicitação de reunião é sincronizada a partir da pasta Itens 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>

ComentáriosComments

O elemento SyncState dados codificados em Base64 e o atributo ID do elemento ItemId foram reduzidos para preservar a legibilidade.The SyncState element base64-encoded data and the ItemId element Id attribute have been shortened to preserve readability.

Elementos de resposta bem-sucedidosSuccessful response elements

Os seguintes elementos são usados na resposta:The following elements are used in the response:

Resposta de erro SyncFolderItemsSyncFolderItems error response

DescriçãoDescription

O exemplo a seguir mostra uma resposta de erro a uma solicitação SyncFolderItems.The following example shows an error response to a SyncFolderItems request. Esse erro foi causado por um SyncState invá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 resposta de erroError response elements

Os seguintes elementos são usados na resposta de erro:The following elements are used in the error response:

Confira tambémSee also