EmptyFolder 操作
EmptyFolder 操作では、メールボックス内のフォルダーが空になります。 必要に応じて、この操作を使用すると、指定したフォルダーのサブフォルダーを削除できます。 サブフォルダーが削除されると、サブフォルダーとサブフォルダー内のメッセージが削除されます。
EmptyFolder 要求の例
説明
次の EmptyFolder 要求の例は、フォルダーを空にする要求を形成する方法を示しています。 次の使用例は、識別されたフォルダーのすべてのサブフォルダーを削除します。
注:
読みやすくするために、FolderId 要素の Id 属性と ChangeKey 属性の値が短縮されました。
コード
<soap:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version ="Exchange2010_SP1"/>
</soap:Header>
<soap:Body>
<m:EmptyFolder DeleteType="HardDelete" DeleteSubFolders="true">
<m:FolderIds>
<t:FolderId Id="AQMkADhhOGU0" ChangeKey="AQAAABYAAABsMB" />
</m:FolderIds>
</m:EmptyFolder>
</soap:Body>
</soap:Envelope>
Comments
この例では、フォルダーに対してハード削除を実行します。
フォルダーは、FolderIds 要素で使用する DistinguishedFolderId 要素または FolderId 要素によって識別できます。
要求要素
要求では、次の要素が使用されます。
EmptyFolder 応答の成功
説明
次の例は、 EmptyFolder 要求に対する正常な応答を示しています。
コード
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="14"
MinorVersion="1"
MajorBuildNumber="164"
MinorBuildNumber="0"
Version="Exchange2010_SP1"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:EmptyFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:EmptyFolderResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
</m:EmptyFolderResponseMessage>
</m:ResponseMessages>
</m:EmptyFolderResponse>
</s:Body>
</s:Envelope>
成功した応答要素
応答では、次の要素が使用されます。
EmptyFolder エラー応答
説明
次の例は、 Emptyfolder 要求に対するエラー応答を示しています。 操作が Exchange ストアで見つからなかったフォルダーを空にしようとしたため、エラーが作成されました。
コード
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="14"
MinorVersion="1"
MajorBuildNumber="164"
MinorBuildNumber="0"
Version="Exchange2010_SP1"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:GetFolderResponse
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetFolderResponseMessage ResponseClass="Error">
<m:MessageText>Id is malformed.</m:MessageText>
<m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:Folders />
</m:GetFolderResponseMessage>
</m:ResponseMessages>
</m:GetFolderResponse>
</s:Body>
</s:Envelope>
エラー応答要素
応答では、次の要素が使用されます。