CopyFolder-Vorgang

  • Artikel

Der CopyFolder-Vorgang kopiert Ordner in einem Postfach.

Verwenden des CopyFolder-Vorgangs

Der CopyFolder-Vorgang ähnelt dem MoveFolder-Vorgang. Es kopiert identifizierte Ordner und gibt die ID und den ChangeKey der kopierten Ordner zurück.

CopyFolder-Anforderungsbeispiel

Beschreibung

Das folgende Beispiel einer CopyFolder-Anforderung zeigt, wie Ordner in den Ordner Posteingang kopiert werden.

Hinweis

Der Wert des Id-Attributs des FolderId-Elements wurde aus Gründen der Lesbarkeit gekürzt.

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

Kommentare

Ordner können entweder durch das DistinguishedFolderId-Element oder das FolderId-Element zur Verwendung in den Elementen ToFolderId oder FolderIds identifiziert werden.

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Hinweis

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, der MicrosoftExchange Server 2007 mit installierter Clientzugriff-Serverrolle ausführt.

Weitere Optionen für die Anforderungsmeldung des CopyFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie am CopyFolder-Element .

Erfolgreiche CopyFolder-Antwort

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die CopyFolder-Anforderung.

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

Kommentar

Das FolderId-Element , das in der Antwort zurückgegeben wird, stellt den Ordner dar, der in den neuen Ordnerspeicherort kopiert wurde.

Antwortelemente

In der Antwort werden folgende Elemente verwendet:

Weitere Optionen für die Antwortnachricht des CopyFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie am CopyFolderResponse-Element .

CopyFolder-Fehlerantwort

Beschreibung

Das folgende Beispiel zeigt eine Fehlerantwort auf eine CopyFolder-Anforderung. Der Fehler ist aufgetreten, weil bereits ein Ordner mit demselben Anzeigenamen vorhanden ist.

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="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>

Fehlerantwortelemente

Folgende Elemente werden in der Fehlerantwort verwendet:

Weitere Optionen für die Fehlermeldung des CopyFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie am CopyFolderResponse-Element .

Siehe auch