CopyFolder 操作

[アーティクル]
03/29/2023

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

フォルダーは、ToFolderId 要素または FolderIds 要素で使用するために、DistinguishedFolderId 要素または FolderId 要素によって識別できます。

要求要素

要求では、次の要素が使用されます。

注:

この要素を記述するスキーマは、クライアントアクセスサーバーの役割がインストールされている 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 要素から開始します。

CopyFolder 操作