Операция MoveFolder

  • Статья

Операция MoveFolder перемещает папки из указанной папки и помещает их в другую папку.

Замечания

Операция MoveFolder аналогична операции CopyFolder. Нельзя перемещать различающиеся папки. Вы можете переместить несколько папок одновременно в целевую папку.

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

Описание

В следующем примере запроса MoveFolder показано, как сформировать запрос на перемещение папки, определенной идентификатором 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>
    <MoveFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ToFolderId>
        <t:DistinguishedFolderId Id="junkemail"/>
      </ToFolderId>
      <FolderIds>
        <t:FolderId Id="AScAc"/>
      </FolderIds>
    </MoveFolder>
  </soap:Body>
</soap:Envelope>

Comments

Примечание.

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

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

Этот запрос MoveFolder включает следующие элементы:

Дополнительные элементы, которые можно использовать для формирования запроса MoveFolder, см. в схеме.

Примечание.

Расположение схемы по умолчанию находится в виртуальном каталоге EWS на компьютере с установленной ролью сервера клиентского доступа.

Пример успешного ответа MoveFolder

Описание

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

Код

<?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="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <MoveFolderResponse 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:MoveFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AAAlAFV" ChangeKey="AQAAAB" />
            </t:Folder>
          </m:Folders>
        </m:MoveFolderResponseMessage>
      </m:ResponseMessages>
    </MoveFolderResponse>
  </soap:Body>
</soap:Envelope>

Comments

Примечание.

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

Идентификатор папки, возвращаемый в ответе, представляет папку, которая была перемещена в новое расположение папки.

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

Ответ MoveFolder содержит следующие элементы:

Пример ответа на ошибку MoveFolder

Описание

В следующем примере показан ответ на ошибку, возникающий при попытке переместить различающуюся папку.

Код

<?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="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <MoveFolderResponse 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:MoveFolderResponseMessage ResponseClass="Error">
          <m:MessageText>Cannot move distinguished folder.</m:MessageText>
          <m:ResponseCode>ErrorMoveDistinguishedFolder</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders />
        </m:MoveFolderResponseMessage>
      </m:ResponseMessages>
    </MoveFolderResponse>
  </soap:Body>
</soap:Envelope>

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

Ответ на ошибку MoveFolder включает следующие элементы:

См. также

Операция CopyFolder