Operação CreateFolder

Artigo
03/29/2023

A operação CreateFolder cria pastas, pastas de calendário, contata pastas, pastas de tarefas e pastas de pesquisa.

Exemplo de solicitação CreateFolder

Descrição

O exemplo a seguir de uma solicitação CreateFolder mostra como formar uma solicitação para criar duas novas pastas na raiz da caixa de correio.

Código

<?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>

Elementos de solicitação

Os seguintes elementos são usados na solicitação:

Observação

O esquema que descreve esses elementos está localizado no diretório virtual do EWS do computador que está executando o MicrosoftExchange Server 2007 que tem a função de servidor do Client Access instalada.

Para encontrar outras opções para a mensagem de solicitação da operação CreateFolder, explore a hierarquia de esquema. Comece no elemento CreateFolder .

Observação

Se você criar uma pasta de pesquisa com uma restrição usando a propriedade calendar:Organizer , uma chamada de pasta get subsequente retornará a restrição com a propriedade message:from em seu lugar. Essas duas propriedades mapeiam para a mesma propriedade MAPI subjacente.

A operação CreateFolder dá suporte à criação de uma classe de pasta personalizada somente quando você cria a pasta usando um elemento de tipo de pasta genérico e define o elemento FolderClass .

Exemplo de resposta CreateFolder bem-sucedido

Descrição

O exemplo a seguir mostra uma resposta bem-sucedida à solicitação CreateFolder. Neste exemplo, a resposta retorna os identificadores das novas pastas.

Observação

A ID da pasta e a chave de alteração foram encurtadas para preservar a legibilidade.

Código

<?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>

Elementos de resposta bem-sucedidos

Os seguintes elementos são usados na resposta:

Para encontrar outras opções para a mensagem de resposta da operação CreateFolder, explore a hierarquia de esquema. Comece no elemento CreateFolderResponse .

Resposta de erro CreateFolder

Descrição

O exemplo a seguir mostra uma resposta de erro a uma solicitação CreateFolder.

Código

<?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>

Elementos de resposta de erro

Os seguintes elementos são usados na resposta de erro:

Para encontrar outras opções para a mensagem de resposta de erro da operação CreateFolder, explore a hierarquia de esquema. Comece no elemento CreateFolderResponse .