CreateFolder-Vorgang

Artikel
03/29/2023

Der CreateFolder-Vorgang erstellt Ordner, Kalenderordner, Kontakteordner, Aufgabenordner und Suchordner.

CreateFolder-Anforderungsbeispiel

Beschreibung

Das folgende Beispiel einer CreateFolder-Anforderung zeigt, wie eine Anforderung zum Erstellen von zwei neuen Ordnern im Postfachstamm erstellt wird.

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>

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Hinweis

Das Schema, das diese Elemente beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, auf dem MicrosoftExchange Server 2007 ausgeführt wird, auf dem die Clientzugriffsserverrolle installiert ist.

Weitere Optionen für die Anforderungsmeldung des CreateFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem CreateFolder-Element .

Hinweis

Wenn Sie mithilfe der calendar:Organizer-Eigenschaft einen Suchordner mit einer Einschränkung erstellen, wird die Einschränkung bei einem nachfolgenden Aufruf von get folder mit der message:from-Eigenschaft an ihrer Stelle zurückgegeben. Diese beiden Eigenschaften sind der gleichen zugrunde liegenden MAPI-Eigenschaft zugeordnet.

Der CreateFolder-Vorgang unterstützt die Erstellung einer benutzerdefinierten Ordnerklasse nur, wenn Sie den Ordner mithilfe eines generischen Ordnertypelements erstellen und das FolderClass-Element festlegen.

Beispiel für eine erfolgreiche CreateFolder-Antwort

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die CreateFolder-Anforderung. In diesem Beispiel gibt die Antwort die Bezeichner der neuen Ordner zurück.

Hinweis

Die Ordner-ID und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

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>

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

Weitere Optionen für die Antwortmeldung des CreateFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem CreateFolderResponse-Element .

CreateFolder-Fehlerantwort

Beschreibung

Das folgende Beispiel zeigt eine Fehlerantwort auf eine CreateFolder-Anforderung.

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>

Fehlerantwortelemente

Folgende Elemente werden in der Fehlerantwort verwendet:

Weitere Optionen für die Fehlermeldung des CreateFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem CreateFolderResponse-Element .