Operación MoveFolderMoveFolder operation

La operación MoveFolder mueve carpetas de una carpeta especificada y las coloca en otra carpeta.The MoveFolder operation moves folders from a specified folder and puts them in another folder.

ComentariosRemarks

La operación MoveFolder es similar a la operación CopyFolder.The MoveFolder operation is similar to the CopyFolder operation. No se pueden mover las carpetas distintivas.You cannot move distinguished folders. Puede mover varias carpetas al mismo tiempo a la carpeta de destino.You can move multiple folders at one time to the destination folder.

Ejemplo de solicitud MoveFolderMoveFolder request example

DescriptionDescription

En el siguiente ejemplo de una solicitud de MoveFolder se muestra cómo crear una solicitud para mover una carpeta identificada por el FolderId y colocar la carpeta en la carpeta completa de correo no deseado.The following example of a MoveFolder request shows how to form a request to move a folder identified by the FolderId and put the folder in the Junk E-mail distinguished folder.

CódigoCode

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

ComentariosComments

Nota

El valor del atributo ID del elemento FolderId se ha abreviado para facilitar su lectura.The value of the ID attribute of the FolderId element has been shortened for readability.

Elementos de solicitudRequest elements

Esta solicitud de MoveFolder incluye los siguientes elementos:This MoveFolder request includes the following elements:

Vea el esquema para ver los elementos adicionales que puede usar para formar una solicitud de MoveFolder.See the schema for additional elements that you can use to form a MoveFolder request.

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 clientes.The default location of the schema is in the EWS virtual directory on the computer that has the Client Access server role installed.

Ejemplo de respuesta MoveFolder correctaSuccessful MoveFolder response example

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta correcta a la solicitud MoveFolder.The following example shows a successful response to the MoveFolder request.

CódigoCode

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

ComentariosComments

Nota

El identificador de la carpeta y la clave de cambio se han abreviado para preservar la legibilidad.The folder ID and the change key have been shortened to preserve readability.

La FolderId que se devuelve en la respuesta representa la carpeta que se movió a la nueva ubicación de la carpeta.The FolderId that is returned in the response represents the folder that was moved to the new the folder location.

Elementos de respuestaResponse elements

La respuesta MoveFolder incluye los siguientes elementos:The MoveFolder response includes the following elements:

Ejemplo de respuesta de error MoveFolderMoveFolder Error response example

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta de error que se produce al intentar mover una carpeta distintiva.The following example shows an error response that occurs when you try to move a distinguished folder.

CódigoCode

<?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 errorError response elements

La respuesta de error MoveFolder incluye los siguientes elementos:The MoveFolder error response includes the following elements:

Vea tambiénSee also

Operación CopyFolderCopyFolder operation