Operación MoveFolder

  • Artículo

La operación MoveFolder mueve las carpetas de una carpeta especificada y las coloca en otra carpeta.

Comentarios

La operación MoveFolder es similar a la operación CopyFolder. No se pueden mover carpetas distinguidas. Puede mover varias carpetas a la vez a la carpeta de destino.

Ejemplo de solicitud MoveFolder

Descripción

En el ejemplo siguiente de una solicitud MoveFolder se muestra cómo formar una solicitud para mover una carpeta identificada por folderId y colocar la carpeta en la carpeta distinguida correo electrónico no deseado.

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>

Comentarios

Nota:

El valor del atributo ID del elemento FolderId se ha acortado para mejorar la legibilidad.

Elementos Request

Esta solicitud MoveFolder incluye los siguientes elementos:

Consulte el esquema para ver los elementos adicionales que puede usar para formar una solicitud MoveFolder.

Nota:

La ubicación predeterminada del esquema está en el directorio virtual de EWS en el equipo que tiene instalado el rol de servidor acceso de cliente.

Ejemplo de respuesta correcta de MoveFolder

Descripción

En el ejemplo siguiente se muestra una respuesta correcta a la solicitud 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>

Comentarios

Nota:

El identificador de carpeta y la clave de cambio se han acortado para conservar la legibilidad.

El FolderId que se devuelve en la respuesta representa la carpeta que se ha movido a la nueva ubicación de la carpeta.

Elementos de respuesta

La respuesta MoveFolder incluye los siguientes elementos:

Ejemplo de respuesta de error de MoveFolder

Descripción

En el ejemplo siguiente se muestra una respuesta de error que se produce al intentar mover una carpeta distinguida.

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

La respuesta de error MoveFolder incluye los siguientes elementos:

Vea también

Operación CopyFolder