FindFolderFindFolder

O elemento FindFolder define uma solicitação para localizar pastas em uma caixa de correio.The FindFolder element defines a request to find folders in a mailbox.

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

FindFolderTypeFindFolderType

Atributos e elementosAttributes and elements

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescriçãoDescription
PassagemTraversal
Define como uma pesquisa é realizada.Defines how a search is performed. Esse atributo é necessário.This attribute is required.

Valores de atributos de passagemTraversal attribute values

ValorValue DescriçãoDescription
SuperficialShallow
Instrui a operação FindFolder a pesquisar somente a pasta identificada e retornar apenas as IDs de pasta para itens que não foram excluídos.Instructs the FindFolder operation to search only the identified folder and to return only the folder IDs for items that have not been deleted. Isso é chamado de passagem superficial.This is called a shallow traversal.
DetalhadasDeep
Instrui a operação FindFolder para pesquisar em todas as pastas filhas da pasta pai identificada e para retornar apenas as IDs de pasta para itens que não foram excluídos.Instructs the FindFolder operation to search in all child folders of the identified parent folder and to return only the folder IDs for items that have not been deleted. Isso é chamado de passagem profunda.This is called a deep traversal.
SoftDeletedSoftDeleted
Instrui a operação FindFolder a realizar uma pesquisa de passagem superficial para itens excluídos.Instructs the FindFolder operation to perform a shallow traversal search for deleted items.

Elementos filhoChild elements

ElementoElement DescriçãoDescription
FolderShapeFolderShape
Identifica as propriedades da pasta a serem incluídas em uma resposta FindFolder.Identifies the folder properties to include in a FindFolder response.
IndexedPageFolderViewIndexedPageFolderView
Descreve como as informações de item paginado são retornadas em uma resposta FindFolder.Describes how paged item information is returned in a FindFolder response. Este elemento é opcional.This element is optional.
FractionalPageFolderViewFractionalPageFolderView
Descreve onde o modo de exibição paginado começa e o número máximo de pastas retornadas em uma solicitação FindFolder.Describes where the paged view starts and the maximum number of folders returned in a FindFolder request. Este elemento é opcional.This element is optional.
RestrictionRestriction
Define uma restrição ou consulta usada para filtrar pastas em uma operação FindFolder.Defines a restriction or query that is used to filter folders in a FindFolder operation. Este elemento é opcional.This element is optional.
ParentFolderIdsParentFolderIds
Identifica pastas para a operação FindFolder a ser pesquisada.Identifies folders for the FindFolder operation to search.

Elementos paiParent elements

NenhumNone.

ComentáriosRemarks

O esquema que descreve este elemento está localizado no diretório virtual do EWS do computador que está executando o Microsoft Exchange Server 2007 que tem a função de servidor de acesso para Cliente instalada.The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

ExemploExample

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.The following example of a FindFolder request shows how to form a request to find all the folders located in an Inbox.

<?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çõesElement information

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquemaSchema Name
Esquema de mensagensMessages schema
Arquivo de validaçãoValidation File
Messages.xsdMessages.xsd
Pode ser vazioCan be Empty
FalseFalse

Confira tambémSee also