Compartilhar via


FindFolder

O elemento FindFolder define uma solicitação para localizar pastas em uma caixa de correio.

<FindFolder Traversal="Shallow/Deep/SoftDeleted">
   <FolderShape/>
   <IndexedPageFolderView/>
   <Restriction/>
   <ParentFolderIds/>
</FindFolder>
<FindFolder Traversal="Shallow/Deep/SoftDeleted">
   <FolderShape/>
   <FractionalPageFolderView/>
   <Restriction/>
   <ParentFolderIds/>
</FindFolder>

Findfoldertype

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo Descrição
Passagem
Define como uma pesquisa é executada. Esse atributo é necessário.

Valores de atributo de travessia

Valor Descrição
Superficial
Instrui a operação FindFolder a pesquisar apenas a pasta identificada e a retornar apenas as IDs de pasta para itens que não foram excluídos. Isso é chamado de travessia superficial.
Profundo
Instrui a operação FindFolder a pesquisar em todas as pastas filho da pasta pai identificada e a retornar apenas as IDs de pasta para itens que não foram excluídos. Isso é chamado de travessia profunda.
SoftDeleted
Instrui a operação FindFolder a executar uma pesquisa de travessia superficial para itens excluídos.

Elementos filho

Elemento Descrição
FolderShape
Identifica as propriedades da pasta a serem incluídas em uma resposta FindFolder.
IndexedPageFolderView
Descreve como as informações de item de página são retornadas em uma resposta FindFolder. Esse elemento é opcional.
FractionalPageFolderView
Descreve onde a exibição de página começa e o número máximo de pastas retornadas em uma solicitação FindFolder. Esse elemento é opcional.
Restriction
Define uma restrição ou consulta usada para filtrar pastas em uma operação FindFolder. Esse elemento é opcional.
ParentFolderIds
Identifica pastas para a operação FindFolder a ser pesquisada.

Elementos pai

Nenhum.

Comentários

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

Exemplo

O exemplo a seguir de uma solicitação FindFolder mostra como formar uma solicitação para localizar todas as pastas localizadas em uma caixa de entrada.

<?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>
    <FindFolder Traversal="Shallow" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <FolderShape>
        <t:BaseShape>Default</t:BaseShape>
      </FolderShape>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="inbox"/>
      </ParentFolderIds>
    </FindFolder>
  </soap:Body>
</soap:Envelope>

Elemento de informações

Elemento Exemplo
Namespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquema
Esquema de mensagens
Arquivo de validação
Messages.xsd
Pode ser vazio
False

Confira também