SyncFolderHierarchy-Vorgang

  • Artikel

Der SyncFolderHierarchy-Vorgang synchronisiert Ordner zwischen dem Computer, auf dem Microsoft Exchange Server 2010 ausgeführt wird, und dem Client.

Hinweis

Der SyncFolderHierarchy-Vorgang gibt keine Ordner zurück, wenn sich die UnreadCount - oder TotalCount-Eigenschaften geändert haben.

Beispiel für eine SyncFolderHierarchy-Anforderung

Beschreibung

Das folgende Beispiel einer SyncFolderHierarchy-Anforderung zeigt, wie eine Clientordnerhierarchie mit dem Exchange-Server synchronisiert wird. Dieses Beispiel zeigt eine Ordnerhierarchie, die bereits mindestens einmal synchronisiert wurde. Das SyncState-Element ist nicht in der Anforderung für den ersten Versuch enthalten, einen Client mit dem Exchange-Server zu synchronisieren. Die erste Anforderung gibt alle Ordner im Postfach zurück. Das SyncState-Element wird in SyncFolderHierarchyResponse zurückgegeben. Dieses Element wird verwendet, um den Zustand für nachfolgende SyncFolderHierarchy-Anforderungen zu synchronisieren.

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>
    <SyncFolderHierarchy  xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <FolderShape>
        <t:BaseShape>AllProperties</t:BaseShape>
      </FolderShape>
      <SyncState>H4sIA=</SyncState>
    </SyncFolderHierarchy>
  </soap:Body>
</soap:Envelope>

Kommentare

Die Base64-codierten Daten des SyncState-Elements wurden gekürzt, um die Lesbarkeit zu erhalten.

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Hinweis

Das Schema, das diese Elemente beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, auf dem MicrosoftExchange Server 2007 ausgeführt wird, auf dem die Clientzugriffsserverrolle installiert ist.

Erfolgreiche SyncFolderHierarchy-Antwort

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die SyncFolderHierarchy-Anforderung. In diesem Beispiel wurde ein neuer Ordner synchronisiert.

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>
    <SyncFolderHierarchyResponse 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:SyncFolderHierarchyResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:SyncState>H4sIAAA==</m:SyncState>
          <m:IncludesLastFolderInRange>true</m:IncludesLastFolderInRange>
          <m:Changes>
            <t:Create>
              <t:Folder>
                <t:FolderId Id="AQApAHR=" ChangeKey="AQAAABY" />
                <t:ParentFolderId Id="AQApA=" ChangeKey="AQAAAA==" />
                <t:FolderClass>IPF.Note</t:FolderClass>
                <t:DisplayName>NewFolder</t:DisplayName>
                <t:TotalCount>0</t:TotalCount>
                <t:ChildFolderCount>0</t:ChildFolderCount>
                <t:UnreadCount>0</t:UnreadCount>
              </t:Folder>
            </t:Create>
          </m:Changes>
        </m:SyncFolderHierarchyResponseMessage>
      </m:ResponseMessages>
    </SyncFolderHierarchyResponse>
  </soap:Body>
</soap:Envelope>

Kommentare

Die Base64-codierten Daten des SyncState-Elements und die Ordnerbezeichnerdaten wurden gekürzt, um die Lesbarkeit zu erhalten.

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

SyncFolderHierarchy-Fehlerantwort

Beschreibung

Das folgende Beispiel zeigt eine Fehlerantwort auf eine SyncFolderHierarchy-Anforderung. Dieser Fehler wurde durch einen ungültigen SyncState verursacht.

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>
    <SyncFolderHierarchyResponse 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:SyncFolderHierarchyResponseMessage ResponseClass="Error">
          <m:MessageText>Synchronization state data is corrupted or otherwise invalid.</m:MessageText>
          <m:ResponseCode>ErrorInvalidSyncStateData</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:SyncState />
          <m:IncludesLastFolderInRange>true</m:IncludesLastFolderInRange>
        </m:SyncFolderHierarchyResponseMessage>
      </m:ResponseMessages>
    </SyncFolderHierarchyResponse>
  </soap:Body>
</soap:Envelope>

Fehlerantwortelemente

Folgende Elemente werden in der Fehlerantwort verwendet:

Siehe auch