Операция CopyFolder

  • Статья

Операция CopyFolder копирует папки в почтовый ящик.

Использование операции CopyFolder

Операция CopyFolder аналогична операции MoveFolder. Он копирует идентифицированные папки и возвращает идентификатор и ключ ChangeKey скопированных папок.

Пример запроса CopyFolder

Описание

В следующем примере запроса CopyFolder показано, как скопировать папки в папку "Входящие".

Примечание.

Значение атрибута Id элемента FolderId сокращено для удобства чтения.

Код

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

Comments

Папки можно определить с помощью элемента DistinguishedFolderId или FolderId для использования в элементах ToFolderId или FolderId.

Элементы запроса

В запросе используются следующие элементы:

Примечание.

Схема, описывающая этот элемент, расположена в виртуальном каталоге EWS на компьютере с MicrosoftExchange Server 2007 и установленной ролью сервера клиентского доступа.

Чтобы найти другие параметры для сообщения запроса операции CopyFolder, изучите иерархию схемы. Начните с элемента CopyFolder .

Успешный ответ CopyFolder

Описание

В следующем примере показан успешный ответ на запрос CopyFolder.

Примечание.

Идентификатор папки и ключ изменения сокращены для сохранения удобочитаемости.

Код

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

Comment

Элемент FolderId , возвращаемый в ответе, представляет папку, скопированную в новое расположение папки.

Элементы ответа

В ответе используются следующие элементы:

Чтобы найти другие параметры для ответного сообщения операции CopyFolder, изучите иерархию схем. Начните с элемента CopyFolderResponse .

Ответ на ошибку CopyFolder

Описание

В следующем примере показан ответ с ошибкой на запрос CopyFolder. Ошибка произошла из-за того, что папка с таким же отображаемым именем уже существует.

Код

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

Элементы ответа на ошибку

В ответе на ошибку используются следующие элементы:

Чтобы найти другие параметры для сообщения об ошибке операции CopyFolder, изучите иерархию схемы. Начните с элемента CopyFolderResponse .

См. также