Opération MoveFolder

  • Article

L’opération MoveFolder déplace les dossiers d’un dossier spécifié et les place dans un autre dossier.

Remarques

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.

Exemple de requête MoveFolder

Description

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é.

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>

Comments

Remarque

La valeur de l’attribut ID de l’élément FolderId a été raccourcie pour plus de lisibilité.

Éléments de requête

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.

Remarque

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é.

Exemple de réponse MoveFolder réussi

Description

L’exemple suivant montre une réponse réussie à la requête MoveFolder.

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>

Comments

Remarque

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.

Éléments de réponse

La réponse MoveFolder comprend les éléments suivants :

Exemple de réponse d’erreur MoveFolder

Description

L’exemple suivant montre une réponse d’erreur qui se produit lorsque vous essayez de déplacer un dossier unique.

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>

Éléments de réponse d’erreur

La réponse d’erreur MoveFolder comprend les éléments suivants :

Voir aussi

Opération CopyFolder