Operação MoveFolder

  • Artigo

A operação MoveFolder move pastas de uma pasta especificada e as coloca em outra pasta.

Comentários

A operação MoveFolder é semelhante à operação CopyFolder. Não é possível mover pastas distintas. Você pode mover várias pastas ao mesmo tempo para a pasta de destino.

Exemplo de solicitação MoveFolder

Descrição

O exemplo a seguir de uma solicitação MoveFolder mostra como formar uma solicitação para mover uma pasta identificada pelo FolderId e colocar a pasta na pasta de lixo eletrônico diferenciado.

Código

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

Comentários

Observação

O valor do atributo ID do elemento FolderId foi reduzido para a capacidade de leitura.

Elementos request

Esta solicitação MoveFolder inclui os seguintes elementos:

Consulte o esquema para obter elementos adicionais que você pode usar para formar uma solicitação MoveFolder.

Observação

O local padrão do esquema está no diretório virtual do EWS no computador que tem a função de servidor de Acesso para Cliente instalada.

Exemplo de resposta bem-sucedida do MoveFolder

Descrição

O exemplo a seguir mostra uma resposta bem-sucedida à solicitação MoveFolder.

Código

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

Comentários

Observação

A ID da pasta e a chave de alteração foram reduzidas para preservar a capacidade de leitura.

A FolderId retornada na resposta representa a pasta que foi movida para o novo local da pasta.

Elementos de resposta

A resposta MoveFolder inclui os seguintes elementos:

Exemplo de resposta de erro moveFolder

Descrição

O exemplo a seguir mostra uma resposta de erro que ocorre quando você tenta mover uma pasta distinta.

Código

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

Elementos de resposta de erro

A resposta de erro MoveFolder inclui os seguintes elementos:

Confira também

Operação CopyFolder