Operación CopyFolder
La operación CopyFolder copia las carpetas de un buzón.
La operación CopyFolder es similar a la operación MoveFolder. Copia las carpetas identificadas y devuelve los valores Id y ChangeKey de las carpetas copiadas.
En el ejemplo siguiente de una solicitud CopyFolder se muestra cómo copiar carpetas en la carpeta Bandeja de entrada.
Nota
El valor del atributo Id del elemento FolderId se ha acortado para mejorar la legibilidad.
<?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>
Las carpetas se pueden identificar mediante el elemento DistinguishedFolderId o el elemento FolderId para su uso en los elementos ToFolderId o FolderIds .
En la solicitud se usan los siguientes elementos:
Nota
El esquema que describe este elemento se encuentra en el directorio virtual EWS del equipo que ejecuta MicrosoftExchange Server 2007 que tiene instalado el rol de servidor acceso de cliente.
Para buscar otras opciones para el mensaje de solicitud de la operación CopyFolder, explore la jerarquía de esquema. Comience en el elemento CopyFolder .
En el ejemplo siguiente se muestra una respuesta correcta a la solicitud CopyFolder.
Nota
El identificador de carpeta y la clave de cambio se han acortado para conservar la legibilidad.
<?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>
El elemento FolderId que se devuelve en la respuesta representa la carpeta que se copió en la nueva ubicación de carpeta.
Los siguientes elementos se usan en la respuesta:
Para buscar otras opciones para el mensaje de respuesta de la operación CopyFolder, explore la jerarquía de esquema. Comience en el elemento CopyFolderResponse .
En el ejemplo siguiente se muestra una respuesta de error a una solicitud CopyFolder. El error se produjo porque ya existe una carpeta con el mismo nombre para mostrar.
<?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>
Los siguientes elementos se usan en la respuesta de error:
Para buscar otras opciones para el mensaje de respuesta de error de la operación CopyFolder, explore la jerarquía de esquema. Comience en el elemento CopyFolderResponse .