CopyFolder 操作

  • 项目

CopyFolder 操作复制邮箱中的文件夹。

使用 CopyFolder 操作

CopyFolder 操作类似于 MoveFolder 操作。 它复制标识的文件夹，并返回复制文件夹的 ID 和 ChangeKey 。

CopyFolder 请求示例

说明

下面的 CopyFolder 请求示例演示如何将文件夹复制到“收件箱”文件夹中。

注意

为了提高可读性，已缩短 FolderId 元素的 Id 属性的值。

代码

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

Comments

文件夹可由 DistinguishedFolderId 元素或 FolderId 元素标识，以便在 ToFolderId 或 FolderIds 元素中使用。

请求元素

请求中使用以下元素：

注意

描述此元素的架构位于正在运行 MicrosoftExchange Server 2007 的计算机（已安装客户端访问服务器角色）的 EWS 虚拟目录中。

若要查找 CopyFolder 操作的请求消息的其他选项，请浏览架构层次结构。 从 CopyFolder 元素开始。

成功的 CopyFolder 响应

说明

以下示例显示了对 CopyFolder 请求的成功响应。

注意

文件夹 ID 和更改密钥已缩短，以保持可读性。

代码

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

评论

响应中返回的 FolderId 元素表示在新文件夹位置中复制的文件夹。

响应元素

响应中使用以下元素：

若要查找 CopyFolder 操作响应消息的其他选项，请浏览架构层次结构。 从 CopyFolderResponse 元素开始。

CopyFolder 错误响应

说明

以下示例显示了对 CopyFolder 请求的错误响应。 发生此错误的原因是已存在具有相同显示名称的文件夹。

代码

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

错误响应元素

错误响应中使用以下元素：

若要查找 CopyFolder 操作的错误响应消息的其他选项，请浏览架构层次结构。 从 CopyFolderResponse 元素开始。

另请参阅