MoveFolder-Vorgang
Der MoveFolder-Vorgang verschiebt Ordner aus einem angegebenen Ordner und legt sie in einem anderen Ordner ab.
Der MoveFolder-Vorgang ähnelt dem CopyFolder-Vorgang. Differenzierte Ordner können nicht verschoben werden. Sie können mehrere Ordner gleichzeitig in den Zielordner verschieben.
Im folgenden Beispiel einer MoveFolder-Anforderung wird gezeigt, wie sie eine Anforderung zum Verschieben eines ordners erstellen, der durch die FolderId identifiziert wird, und den Ordner in den Junk-E-Mail-Ordner ablegen.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<MoveFolder xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ToFolderId>
<t:DistinguishedFolderId Id="junkemail"/>
</ToFolderId>
<FolderIds>
<t:FolderId Id="AScAc"/>
</FolderIds>
</MoveFolder>
</soap:Body>
</soap:Envelope>
Hinweis
Der Wert des ID-Attributs des FolderId-Elements wurde aus Gründen der Lesbarkeit gekürzt.
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.
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die MoveFolder-Anforderung.
<?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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<MoveFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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>
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.
Die MoveFolder-Antwort enthält die folgenden Elemente:
Das folgende Beispiel zeigt eine Fehlerantwort, die auftritt, wenn Sie versuchen, einen distinguished folder zu verschieben.
<?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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<MoveFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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>
Die MoveFolder-Fehlerantwort enthält die folgenden Elemente: