Operación CreateFolder
La operación CreateFolder crea carpetas, carpetas de calendario, carpetas de contactos, carpetas de tareas y carpetas de búsqueda.
En el ejemplo siguiente de una solicitud CreateFolder se muestra cómo formar una solicitud para crear dos carpetas nuevas en la raíz del buzón.
<?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>
<CreateFolder xmlns="http://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>
En la solicitud se usan los siguientes elementos:
Nota
El esquema que describe estos elementos se encuentra en el directorio virtual EWS del equipo que ejecuta MicrosoftExchange Server 2007 que tiene instalado el rol de servidor acceso de cliente.
Para buscar otras opciones para el mensaje de solicitud de la operación CreateFolder, explore la jerarquía de esquema. Comience en el elemento CreateFolder .
Nota
Si crea una carpeta de búsqueda con una restricción mediante la propiedad calendar:Organizer , una llamada a la carpeta get posterior devolverá la restricción con la propiedad message:from en su lugar. Estas dos propiedades se asignan a la misma propiedad MAPI subyacente.
La operación CreateFolder admite la creación de una clase de carpeta personalizada solo cuando se crea la carpeta mediante un elemento de tipo de carpeta genérico y se establece el elemento FolderClass .
En el ejemplo siguiente se muestra una respuesta correcta a la solicitud CreateFolder. En este ejemplo, la respuesta devuelve los identificadores de las nuevas carpetas.
Nota
El identificador de carpeta y la clave de cambio se han acortado para conservar la legibilidad.
<?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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<CreateFolderResponse 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: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>
Los siguientes elementos se usan en la respuesta:
Para buscar otras opciones para el mensaje de respuesta de la operación CreateFolder, explore la jerarquía de esquema. Comience en el elemento CreateFolderResponse .
En el ejemplo siguiente se muestra una respuesta de error a una solicitud 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="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<CreateFolderResponse 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: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>
Los siguientes elementos se usan en la respuesta de error:
Para buscar otras opciones para el mensaje de respuesta de error de la operación CreateFolder, explore la jerarquía de esquemas. Comience en el elemento CreateFolderResponse .
CreateFolderType