Operação CopyFolder
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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CopyFolder xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<CopyFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<CopyFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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 .