MoveFolder-Vorgang

  • Artikel

Der MoveFolder-Vorgang verschiebt Ordner aus einem angegebenen Ordner und legt sie in einem anderen Ordner ab.

HinwBemerkungeneise

Der MoveFolder-Vorgang ähnelt dem CopyFolder-Vorgang. Differenzierte Ordner können nicht verschoben werden. Sie können mehrere Ordner gleichzeitig in den Zielordner verschieben.

Beispiel für eine MoveFolder-Anforderung

Beschreibung

Im folgenden Beispiel einer MoveFolder-Anforderung wird gezeigt, wie eine Anforderung zum Verschieben eines ordners erstellt wird, der durch die FolderId identifiziert wird, und den Ordner im Junk-E-Mail-Ordner abgelegt wird.

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>
    <MoveFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ToFolderId>
        <t:DistinguishedFolderId Id="junkemail"/>
      </ToFolderId>
      <FolderIds>
        <t:FolderId Id="AScAc"/>
      </FolderIds>
    </MoveFolder>
  </soap:Body>
</soap:Envelope>

Kommentare

Hinweis

Der Wert des ID-Attributs des FolderId-Elements wurde aus Gründen der Lesbarkeit gekürzt.

Anfordern von Elementen

Diese MoveFolder-Anforderung enthält die folgenden Elemente:

Weitere Elemente, die Sie zum Erstellen einer MoveFolder-Anforderung verwenden können, finden Sie im Schema.

Hinweis

Der Standardspeicherort des Schemas befindet sich im virtuellen EWS-Verzeichnis auf dem Computer, auf dem die Clientzugriffsserverrolle installiert ist.

Beispiel für eine erfolgreiche MoveFolder-Antwort

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die MoveFolder-Anforderung.

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="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <MoveFolderResponse 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:MoveFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AAAlAFV" ChangeKey="AQAAAB" />
            </t:Folder>
          </m:Folders>
        </m:MoveFolderResponseMessage>
      </m:ResponseMessages>
    </MoveFolderResponse>
  </soap:Body>
</soap:Envelope>

Kommentare

Hinweis

Die Ordner-ID und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

Die FolderId, die in der Antwort zurückgegeben wird, stellt den Ordner dar, der in den neuen Ordnerspeicherort verschoben wurde.

Antwortelemente

Die MoveFolder-Antwort enthält die folgenden Elemente:

Beispiel für moveFolder-Fehlerantwort

Beschreibung

Das folgende Beispiel zeigt eine Fehlerantwort, die auftritt, wenn Sie versuchen, einen distinguished folder zu verschieben.

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="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <MoveFolderResponse 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:MoveFolderResponseMessage ResponseClass="Error">
          <m:MessageText>Cannot move distinguished folder.</m:MessageText>
          <m:ResponseCode>ErrorMoveDistinguishedFolder</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders />
        </m:MoveFolderResponseMessage>
      </m:ResponseMessages>
    </MoveFolderResponse>
  </soap:Body>
</soap:Envelope>

Fehlerantwortelemente

Die MoveFolder-Fehlerantwort enthält die folgenden Elemente:

Siehe auch

CopyFolder-Vorgang