Opération MoveFolderMoveFolder operation

L’opération MoveFolder déplace les dossiers d’un dossier spécifié et les place dans un autre dossier.The MoveFolder operation moves folders from a specified folder and puts them in another folder.

RemarquesRemarks

L’opération MoveFolder est similaire à l’opération CopyFolder.The MoveFolder operation is similar to the CopyFolder operation. Vous ne pouvez pas déplacer des dossiers uniques.You cannot move distinguished folders. Vous pouvez déplacer plusieurs dossiers à la fois vers le dossier de destination.You can move multiple folders at one time to the destination folder.

Exemple de requête MoveFolderMoveFolder request example

DescriptionDescription

L’exemple de requête MoveFolder suivant montre comment créer une demande de déplacement d’un dossier identifié par le FolderId et placer le dossier dans le dossier unique du courrier indésirable.The following example of a MoveFolder request shows how to form a request to move a folder identified by the FolderId and put the folder in the Junk E-mail distinguished folder.

CodeCode

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

CommentairesComments

Notes

La valeur de l’attribut ID de l’élément FolderId a été raccourcie pour des raisons de lisibilité.The value of the ID attribute of the FolderId element has been shortened for readability.

Demander des élémentsRequest elements

Cette requête MoveFolder inclut les éléments suivants :This MoveFolder request includes the following elements:

Consultez le schéma pour les éléments supplémentaires que vous pouvez utiliser pour former une requête MoveFolder.See the schema for additional elements that you can use to form a MoveFolder request.

Notes

L’emplacement par défaut du schéma se trouve dans le répertoire virtuel EWS de l’ordinateur sur lequel le rôle serveur d’accès au client est installé.The default location of the schema is in the EWS virtual directory on the computer that has the Client Access server role installed.

Exemple de réponse MoveFolder réussiSuccessful MoveFolder response example

DescriptionDescription

L’exemple suivant montre une réponse réussie à la demande MoveFolder.The following example shows a successful response to the MoveFolder request.

CodeCode

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

CommentairesComments

Notes

L’ID de dossier et la clé de modification ont été raccourcies afin de préserver la lisibilité.The folder ID and the change key have been shortened to preserve readability.

Le FolderId renvoyé dans la réponse représente le dossier déplacé vers le nouvel emplacement du dossier.The FolderId that is returned in the response represents the folder that was moved to the new the folder location.

Éléments ResponseResponse elements

La réponse MoveFolder comprend les éléments suivants :The MoveFolder response includes the following elements:

Exemple de réponse d’erreur MoveFolderMoveFolder Error response example

DescriptionDescription

L’exemple suivant montre une réponse d’erreur qui se produit lorsque vous essayez de déplacer un dossier unique.The following example shows an error response that occurs when you try to move a distinguished folder.

CodeCode

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

Éléments de réponse d’erreurError response elements

La réponse d’erreur MoveFolder comprend les éléments suivants :The MoveFolder error response includes the following elements:

Voir aussiSee also

CopyFolder, opérationCopyFolder operation