Операция CreateFolder

Статья
09/24/2021

Операция CreateFolder создает папки, папки календаря, папки контактов, папки задач и папки поиска.

Пример запроса CreateFolder

Описание

В следующем примере запроса 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>

Элементы запроса

В запросе используются следующие элементы:

Примечание

Схема, описываемая этими элементами, расположена в виртуальном каталоге EWS компьютера под управлением MicrosoftExchange Server 2007, где установлена роль сервера клиентского доступа.

Чтобы найти другие параметры сообщения запроса операции CreateFolder, ознакомьтесь с иерархией схемы. Начните с элемента CreateFolder.

Примечание

Если вы создаете папку поиска с ограничением с помощью свойства calendar:Organis, последующий вызов папки получения возвращает ограничение с сообщением:from property на своем месте. Эти два свойства соеди-

Операция CreateFolder поддерживает создание настраиваемого класса папок только при создании папки с помощью элемента типа общей папки и набора элемента FolderClass.

Пример успешного ответа CreateFolder

Описание

В следующем примере показан успешный ответ на запрос 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

Описание

В следующем примере показан ответ на ошибку на запрос 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.