CopyFolder, opérationCopyFolder operation

L’opération CopyFolder copie les dossiers d’une boîte aux lettres.The CopyFolder operation copies folders in a mailbox.

Utilisation de l’opération CopyFolderUsing the CopyFolder operation

L’opération CopyFolder est semblable à l' opération MoveFolder.The CopyFolder operation is similar to the MoveFolder operation. Il copie les dossiers identifiés et renvoie l' ID et ChangeKey des dossiers copiés.It copies identified folders and returns the Id and ChangeKey of the copied folders.

Exemple de requête CopyFolderCopyFolder request example

DescriptionDescription

L’exemple de requête CopyFolder suivant montre comment copier des dossiers dans le dossier boîte de réception.The following example of a CopyFolder request shows how to copy folders into the Inbox folder.

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.

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>
    <CopyFolder xmlns="https://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>

CommentairesComments

Les dossiers peuvent être identifiés par l’élément DistinguishedFolderId ou l’élément FolderId pour une utilisation dans les éléments ToFolderId ou FolderIds .Folders can be identified by either the DistinguishedFolderId element or the FolderId element for use in either the ToFolderId or the FolderIds elements.

Demander des élémentsRequest elements

Les éléments suivants sont utilisés dans la demande :The following elements are used in the request:

Notes

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é.The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

Pour rechercher d’autres options pour le message de demande de l’opération CopyFolder, explorez la hiérarchie du schéma.To find other options for the request message of the CopyFolder operation, explore the schema hierarchy. Commencez par l’élément CopyFolder .Start at the CopyFolder element.

Réponse CopyFolder réussieSuccessful CopyFolder response

DescriptionDescription

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

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.

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="595" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <CopyFolderResponse 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: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>

CommentaireComment

L’élément FolderId renvoyé dans la réponse représente le dossier qui a été copié dans le nouvel emplacement de dossier.The FolderId element that is returned in the response represents the folder that was copied in the new folder location.

Éléments ResponseResponse elements

Les éléments suivants sont utilisés dans la réponse :The following elements are used in the response:

Pour rechercher d’autres options pour le message de réponse de l’opération CopyFolder, explorez la hiérarchie du schéma.To find other options for the response message of the CopyFolder operation, explore the schema hierarchy. Commencez par l’élément CopyFolderResponse .Start at the CopyFolderResponse element.

Réponse d’erreur CopyFolderCopyFolder error response

DescriptionDescription

L’exemple suivant montre une réponse d’erreur à une demande CopyFolder.The following example shows an error response to a CopyFolder request. L’erreur s’est produite car un dossier portant le même nom d’affichage existe déjà.The error occurred because a folder with the same display name already exists.

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="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <CopyFolderResponse 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: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’erreurError response elements

Les éléments suivants sont utilisés dans la réponse d'erreur :The following elements are used in the error response:

Pour rechercher d’autres options pour le message d’erreur de l’opération CopyFolder, explorez la hiérarchie du schéma.To find other options for the error response message of the CopyFolder operation, explore the schema hierarchy. Commencez par l’élément CopyFolderResponse .Start at the CopyFolderResponse element.

Voir aussiSee also