Operação CopyFolder

  • Artigo

A operação CopyFolder copia pastas em uma caixa de correio.

Usando a operação CopyFolder

A operação CopyFolder é semelhante à operação MoveFolder. Ele copia pastas identificadas e retorna a ID e o ChangeKey das pastas copiadas.

Exemplo de solicitação CopyFolder

Descrição

O exemplo a seguir de uma solicitação CopyFolder mostra como copiar pastas na pasta Caixa de Entrada.

Observação

O valor do atributo Id do elemento FolderId foi abreviado para legibilidade.

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

As pastas podem ser identificadas pelo elemento DistinguishedFolderId ou pelo elemento FolderId para uso nos elementos ToFolderId ou FolderIds .

Elementos de solicitação

Os seguintes elementos são usados na solicitação:

Observação

O esquema que descreve este elemento está localizado no diretório virtual do EWS do computador que está executando o MicrosoftExchange Server 2007 que tem instalada a função de servidor de Acesso para Cliente.

Para encontrar outras opções para a mensagem de solicitação da operação CopyFolder, explore a hierarquia de esquema. Comece no elemento CopyFolder .

Resposta do CopyFolder bem-sucedida

Descrição

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

Observação

A ID da pasta e a chave de alteração foram encurtadas para preservar a legibilidade.

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

Comentário

O elemento FolderId retornado na resposta representa a pasta copiada no novo local da pasta.

Elementos de resposta

Os seguintes elementos são usados na resposta:

Para encontrar outras opções para a mensagem de resposta da operação CopyFolder, explore a hierarquia de esquema. Comece no elemento CopyFolderResponse .

Resposta de erro do CopyFolder

Descrição

O exemplo a seguir mostra uma resposta de erro a uma solicitação CopyFolder. O erro ocorreu porque uma pasta com o mesmo nome de exibição já existe.

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

Elementos de resposta de erro

Os seguintes elementos são usados na resposta de erro:

Para encontrar outras opções para a mensagem de resposta de erro da operação CopyFolder, explore a hierarquia de esquema. Comece no elemento CopyFolderResponse .

Confira também