CreateFolder 操作
CreateFolder 操作创建文件夹、日历文件夹、联系人文件夹、任务文件夹和搜索文件夹。
CreateFolder 请求示例
Description
CreateFolder 请求的以下示例显示如何形成请求,以在邮箱根目录下创建两个新文件夹。
代码
<?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>
<CreateFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ParentFolderId>
<t:DistinguishedFolderId Id="msgfolderroot"/>
</ParentFolderId>
<Folders>
<t:Folder>
<t:DisplayName>Folder1</t:DisplayName>
</t:Folder>
<t:Folder>
<t:DisplayName>Folder2</t:DisplayName>
</t:Folder>
</Folders>
</CreateFolder>
</soap:Body>
</soap:Envelope>
请求元素
请求中会使用下列元素:
备注
描述这些元素的架构位于运行安装了客户端访问服务器角色的 MicrosoftExchange Server 2007 的计算机的 EWS 虚拟目录中。
若要查找 CreateFolder 操作的请求消息的其他选项,请浏览架构层次结构。 从 CreateFolder 元素 开始。
备注
如果使用 calendar:Organizer 属性创建具有限制的搜索文件夹,后续的 get 文件夹调用将返回限制,其位置为 message:from 属性。 这两个属性映射到相同的基础 MAPI 属性。
只有在使用通用文件夹类型元素创建文件夹并设置 FolderClass 元素时 ,CreateFolder 操作才支持创建自定义文件夹类。
成功的 CreateFolder 响应示例
Description
以下示例显示了对 CreateFolder 请求的成功响应。 本示例中,响应返回新文件夹的标识符。
备注
已缩短文件夹 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>
<CreateFolderResponse 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:CreateFolderResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Folders>
<t:Folder>
<t:FolderId Id="AS4AUn==" />
</t:Folder>
</m:Folders>
</m:CreateFolderResponseMessage>
<m:CreateFolderResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Folders>
<t:Folder>
<t:FolderId Id="AS4AUn==" />
</t:Folder>
</m:Folders>
</m:CreateFolderResponseMessage>
</m:ResponseMessages>
</CreateFolderResponse>
</soap:Body>
</soap:Envelope>
成功的响应元素
响应中会使用下列元素:
若要查找 CreateFolder 操作的响应消息的其他选项,请浏览架构层次结构。 从 CreateFolderResponse 元素 开始。
CreateFolder 错误响应
Description
以下示例显示对 CreateFolder 请求的错误响应。
代码
<?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>
<CreateFolderResponse 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:CreateFolderResponseMessage ResponseClass="Error">
<m:MessageText>A folder with the specified name already exists.</m:MessageText>
<m:ResponseCode>ErrorFolderExists</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:Folders />
</m:CreateFolderResponseMessage>
</m:ResponseMessages>
</CreateFolderResponse>
</soap:Body>
</soap:Envelope>
错误响应元素
错误响应中会使用下列元素:
若要查找 CreateFolder 操作的错误响应消息的其他选项,请浏览架构层次结构。 从 CreateFolderResponse 元素 开始。
另请参阅
CreateFolderType