Операция SyncFolderItemsSyncFolderItems operation

Операция SyncFolderItems синхронизирует элементы между сервером Exchange Server и клиентом.The SyncFolderItems operation synchronizes items between the Exchange server and the client.

ПримечанияRemarks

Для операции SyncFolderItems будет возвращено не более 512 изменений.The SyncFolderItems operation will return a maximum of 512 changes. Для получения дополнительных изменений необходимо выполнить последующие запросы SyncFolderItems.Subsequent SyncFolderItems requests must be performed to get additional changes.

SyncFolderItems аналогичен операции FindItem, так как она не может возвращать такие свойства, как текст или вложения.SyncFolderItems is similar to the FindItem operation in that it cannot return properties like Body or Attachments. Если операция SyncFolderItems не возвращает нужные свойства, можно использовать операцию GetItem для получения определенного набора свойств для каждого элемента, возвращенного 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.

Пример запроса SyncFolderItemsSyncFolderItems request example

DescriptionDescription

В приведенном ниже примере запроса SyncFolderItems показано, как синхронизировать элементы в папке.The following example of a SyncFolderItems request shows how to synchronize items in a folder. В этом примере показана синхронизация элемента папки, которая не является первой синхронизацией, которая возникла для папки "Отправленные".This example shows a folder item's synchronization that is not the first synchronization to have occurred for the Sent Items folder. Элемент синкстате не включается в запрос первой попытки синхронизации клиента с сервером Exchange.The SyncState element is not included in the request for the first attempt to synchronize a client with the Exchange server. При первой попытке синхронизации элементов в иерархии папок будут возвращены все элементы почтового ящика, кроме элементов, указанных в элементе 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. Этот запрос SyncFolderItems попытается выполнить синхронизацию всех изменений элементов папки с момента последней синхронизации.This SyncFolderItems request will try to synchronize all changes to the folder items since the last synchronization. Этот запрос будет игнорировать попытку синхронизации одного элемента, указанного в элементе Ignore .This request will ignore the attempt to synchronize the one item that is identified in the Ignore element.

КодCode

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

КомментарииComments

Данные элемента синкстате с кодировкой base64 и атрибут идентификатора элемента ItemId были сокращены для сохранения удобочитаемости.The SyncState element base64-encoded data and the ItemId element Id attribute have been shortened to preserve readability.

Элементы RequestRequest elements

В запросе используются следующие элементы:The following elements are used in the request:

Успешный ответ SyncFolderItemsSuccessful SyncFolderItems Response

DescriptionDescription

В следующем примере показан успешный ответ на запрос SyncFolderItems.The following example shows a successful response to the SyncFolderItems request. В этом примере приглашение на собрание синхронизируется из папки "Отправленные".In this example, a meeting request is synchronized from the Sent Items folder.

КодCode

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

КомментарииComments

Данные элемента синкстате с кодировкой base64 и атрибут идентификатора элемента ItemId были сокращены для сохранения удобочитаемости.The SyncState element base64-encoded data and the ItemId element Id attribute have been shortened to preserve readability.

Элементы успешного ответаSuccessful response elements

В отклике используются следующие элементы:The following elements are used in the response:

Ответ об ошибке SyncFolderItemsSyncFolderItems error response

DescriptionDescription

В следующем примере показан ответ об ошибке для запроса SyncFolderItems.The following example shows an error response to a SyncFolderItems request. Эта ошибка вызвана недопустимым Синкстате.This error was caused by an invalid SyncState.

КодCode

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

Элементы ошибочного ответаError response elements

В ответе на сообщение об ошибке используются следующие элементы:The following elements are used in the error response:

См. такжеSee also