MoveFolder 操作
MoveFolder 操作は、指定したフォルダーからフォルダーを移動し、別のフォルダーに配置します。
注釈
MoveFolder 操作は、CopyFolder 操作に似ています。 識別フォルダーを移動することはできません。 複数のフォルダーを一度に移動先フォルダーに移動できます。
MoveFolder 要求の例
説明
次の MoveFolder 要求の例は、 FolderId によって識別されたフォルダーを移動し、そのフォルダーを迷惑メール識別フォルダーに配置する要求を形成する方法を示しています。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<MoveFolder xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ToFolderId>
<t:DistinguishedFolderId Id="junkemail"/>
</ToFolderId>
<FolderIds>
<t:FolderId Id="AScAc"/>
</FolderIds>
</MoveFolder>
</soap:Body>
</soap:Envelope>
Comments
注:
FolderId 要素の ID 属性の値は、読みやすくするために短縮されました。
要求要素
この MoveFolder 要求には、次の要素が含まれています。
MoveFolder 要求の形成に使用できる追加の要素については、スキーマを参照してください。
注:
スキーマの既定の場所は、クライアント アクセス サーバーの役割がインストールされているコンピューター上の EWS 仮想ディレクトリにあります。
MoveFolder 応答の成功の例
説明
次の例は、MoveFolder 要求に対する正常な応答を示しています。
コード
<?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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<MoveFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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>
Comments
注:
読みやすくするために、フォルダー ID と変更キーが短縮されました。
応答で返される FolderId は、新しいフォルダーの場所に移動されたフォルダーを表します。
応答要素
MoveFolder 応答には、次の要素が含まれています。
MoveFolder エラー応答の例
説明
次の例は、識別フォルダーを移動しようとしたときに発生するエラー応答を示しています。
コード
<?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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<MoveFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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>
エラー応答要素
MoveFolder エラー応答には、次の要素が含まれています。