Opération MoveFolder
L’opération MoveFolder déplace les dossiers d’un dossier spécifié et les place dans un autre dossier.
L’opération MoveFolder est similaire à l’opération CopyFolder. Vous ne pouvez pas déplacer de dossiers distingués. Vous pouvez déplacer plusieurs dossiers à la fois vers le dossier de destination.
L’exemple suivant de demande MoveFolder montre comment former une demande de déplacement d’un dossier identifié par folderId et placer le dossier dans le dossier de courrier indésirable distingué.
<?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>
Note
La valeur de l’attribut ID de l’élément FolderId a été raccourcie pour plus de lisibilité.
Cette demande MoveFolder comprend les éléments suivants :
Consultez le schéma pour obtenir des éléments supplémentaires que vous pouvez utiliser pour former une requête MoveFolder.
Note
L’emplacement par défaut du schéma se trouve dans le répertoire virtuel EWS sur l’ordinateur sur lequel le rôle serveur d’accès au client est installé.
L’exemple suivant montre une réponse réussie à la requête MoveFolder.
<?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>
Note
L’ID de dossier et la clé de modification ont été raccourcis pour préserver la lisibilité.
Le FolderId retourné dans la réponse représente le dossier qui a été déplacé vers le nouvel emplacement du dossier.
La réponse MoveFolder comprend les éléments suivants :
L’exemple suivant montre une réponse d’erreur qui se produit lorsque vous essayez de déplacer un dossier unique.
<?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>
La réponse d’erreur MoveFolder comprend les éléments suivants :