Opération CopyFolder

  • Article

L’opération CopyFolder copie les dossiers d’une boîte aux lettres.

Utilisation de l’opération CopyFolder

L’opération CopyFolder est similaire à l’opération MoveFolder. Il copie les dossiers identifiés et retourne l’ID et la clé de modification des dossiers copiés.

Exemple de requête CopyFolder

Description

L’exemple suivant de requête CopyFolder montre comment copier des dossiers dans le dossier Boîte de réception.

Remarque

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

Code

<?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>
    <CopyFolder xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ToFolderId>
        <t:DistinguishedFolderId Id="inbox"/>
      </ToFolderId>
      <FolderIds>
        <t:FolderId Id="AS4A=" ChangeKey="fsVU4=="/>
        <t:FolderId Id="AS4AU=" ChangeKey="fsVU4o=="/>
      </FolderIds>
    </CopyFolder>
  </soap:Body>
</soap:Envelope>

Comments

Les dossiers peuvent être identifiés par l’élément DistinguishedFolderId ou l’élément FolderId à utiliser dans les éléments ToFolderId ou FolderIds .

Éléments de requête

Les éléments suivants sont utilisés dans la demande :

Remarque

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel EWS de l'ordinateur qui exécute MicrosoftExchange Server 2007 pour lequel le rôle serveur d'accès au client est installé.

Pour trouver d’autres options pour le message de demande de l’opération CopyFolder, explorez la hiérarchie de schéma. Commencez par l’élément CopyFolder .

Réponse copyFolder réussie

Description

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

Remarque

L’ID de dossier et la clé de modification ont été raccourcis pour préserver la lisibilité.

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="595" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <CopyFolderResponse 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:CopyFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AS4AUn=" ChangeKey="fsVU4o==" />
            </t:Folder>
          </m:Folders>
        </m:CopyFolderResponseMessage>
      </m:ResponseMessages>
    </CopyFolderResponse>
  </soap:Body>
</soap:Envelope>

Commentaire

L’élément FolderId retourné dans la réponse représente le dossier qui a été copié dans le nouvel emplacement du dossier.

Éléments de réponse

Les éléments suivants sont utilisés dans la réponse :

Pour trouver d’autres options pour le message de réponse de l’opération CopyFolder, explorez la hiérarchie de schéma. Commencez à l’élément CopyFolderResponse .

Réponse d’erreur CopyFolder

Description

L’exemple suivant montre une réponse d’erreur à une requête CopyFolder. L’erreur s’est produite car un dossier portant le même nom complet existe déjà.

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="628" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <CopyFolderResponse 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:CopyFolderResponseMessage ResponseClass="Error">
          <m:MessageText>The move or copy operation failed.</m:MessageText>
          <m:ResponseCode>ErrorMoveCopyFailed</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders />
        </m:CopyFolderResponseMessage>
      </m:ResponseMessages>
    </CopyFolderResponse>
  </soap:Body>
</soap:Envelope>

Éléments de réponse d’erreur

Les éléments suivants sont utilisés dans la réponse d'erreur :

Pour trouver d’autres options pour le message de réponse d’erreur de l’opération CopyFolder, explorez la hiérarchie de schéma. Commencez à l’élément CopyFolderResponse .

Voir aussi