Operación CopyFolder

  • Artículo

La operación CopyFolder copia las carpetas de un buzón.

Uso de la operación CopyFolder

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.

Ejemplo de solicitud copyFolder

Descripción

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.

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>

Comentarios

Las carpetas se pueden identificar mediante el elemento DistinguishedFolderId o el elemento FolderId para su uso en los elementos ToFolderId o FolderIds .

Elementos Request

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 .

Respuesta correcta de CopyFolder

Descripción

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.

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>

Comentario

El elemento FolderId que se devuelve en la respuesta representa la carpeta que se copió en la nueva ubicación de carpeta.

Elementos de respuesta

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 .

Respuesta de error de CopyFolder

Descripción

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.

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 respuesta de error

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 .

Vea también