Opération CreateFolder

Article
03/29/2023

L’opération CreateFolder crée des dossiers, des dossiers de calendrier, des dossiers de contacts, des dossiers de tâches et des dossiers de recherche.

Exemple de requête CreateFolder

Description

L’exemple suivant de demande CreateFolder montre comment former une demande pour créer deux nouveaux dossiers à la racine de la boîte aux lettres.

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>
    <CreateFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ParentFolderId>
        <t:DistinguishedFolderId Id="msgfolderroot"/>
      </ParentFolderId>
      <Folders>
        <t:Folder>
          <t:DisplayName>Folder1</t:DisplayName>
        </t:Folder>
        <t:Folder>
          <t:DisplayName>Folder2</t:DisplayName>
        </t:Folder>
      </Folders>
    </CreateFolder>
  </soap:Body>
</soap:Envelope>

Éléments de requête

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

Remarque

Le schéma qui décrit ces éléments se trouve dans le répertoire virtuel EWS de l’ordinateur exécutant MicrosoftExchange Server 2007 sur 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 CreateFolder, explorez la hiérarchie de schéma. Commencez par l’élément CreateFolder .

Remarque

Si vous créez un dossier de recherche avec une restriction à l’aide de la propriété calendar:Organizer , un appel de dossier suivant renvoie la restriction avec la propriété message:from à sa place. Ces deux propriétés sont mappées à la même propriété MAPI sous-jacente.

L’opération CreateFolder prend en charge la création d’une classe de dossier personnalisé uniquement lorsque vous créez le dossier à l’aide d’un élément de type dossier générique et que vous définissez l’élément FolderClass .

Exemple de réponse CreateFolder réussi

Description

L’exemple suivant montre une réponse réussie à la requête CreateFolder. Dans cet exemple, la réponse retourne les identificateurs des nouveaux dossiers.

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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <CreateFolderResponse 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:CreateFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AS4AUn==" />
            </t:Folder>
          </m:Folders>
        </m:CreateFolderResponseMessage>
        <m:CreateFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AS4AUn==" />
            </t:Folder>
          </m:Folders>
        </m:CreateFolderResponseMessage>
      </m:ResponseMessages>
    </CreateFolderResponse>
  </soap:Body>
</soap:Envelope>

Éléments de réponse réussis

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 CreateFolder, explorez la hiérarchie de schéma. Commencez par l’élément CreateFolderResponse .

Réponse d’erreur CreateFolder

Description

L’exemple suivant montre une réponse d’erreur à une requête CreateFolder.

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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <CreateFolderResponse 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:CreateFolderResponseMessage ResponseClass="Error">
          <m:MessageText>A folder with the specified name already exists.</m:MessageText>
          <m:ResponseCode>ErrorFolderExists</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders />
        </m:CreateFolderResponseMessage>
      </m:ResponseMessages>
    </CreateFolderResponse>
  </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 CreateFolder, explorez la hiérarchie de schéma. Commencez par l’élément CreateFolderResponse .