FindFolderFindFolder

El elemento FindFolder define una solicitud para buscar carpetas en un buzón.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 y elementosAttributes and elements

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
TransversalTraversal
Define cómo se realiza una búsqueda.Defines how a search is performed. Este atributo es obligatorio.This attribute is required.

Valores de atributo de recorridoTraversal attribute values

ValorValue DescripciónDescription
ProfundaShallow
Indica a la operación FindFolder que busque sólo en la carpeta identificada y que devuelva sólo los identificadores de la carpeta para los elementos que no se han eliminado.Instructs the FindFolder operation to search only the identified folder and to return only the folder IDs for items that have not been deleted. Esto se denomina recorrido superficial.This is called a shallow traversal.
GranDeep
Indica a la operación FindFolder que busque en todas las carpetas secundarias de la carpeta principal identificada y que devuelva sólo los identificadores de carpeta de los elementos que no se han eliminado.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. Esto se denomina recorrido profundo.This is called a deep traversal.
SoftDeletedSoftDeleted
Indica a la operación FindFolder que realice una búsqueda de recorrido superficial para los elementos eliminados.Instructs the FindFolder operation to perform a shallow traversal search for deleted items.

Elementos secundariosChild elements

ElementoElement DescripciónDescription
FolderShapeFolderShape
Identifica las propiedades de carpeta que se deben incluir en una respuesta FindFolder.Identifies the folder properties to include in a FindFolder response.
IndexedPageFolderViewIndexedPageFolderView
Describe cómo se devuelve la información de elementos paginados en una respuesta FindFolder.Describes how paged item information is returned in a FindFolder response. Este elemento es opcional.This element is optional.
FractionalPageFolderViewFractionalPageFolderView
Describe dónde se inicia la vista paginada y el número máximo de carpetas que se devuelven en una solicitud FindFolder.Describes where the paged view starts and the maximum number of folders returned in a FindFolder request. Este elemento es opcional.This element is optional.
RestrictionRestriction
Define una restricción o consulta que se usa para filtrar las carpetas en una operación FindFolder.Defines a restriction or query that is used to filter folders in a FindFolder operation. Este elemento es opcional.This element is optional.
ParentFolderIdsParentFolderIds
Identifica las carpetas para la operación FindFolder que se va a buscar.Identifies folders for the FindFolder operation to search.

Elementos principalesParent elements

Ninguno.None.

ComentariosRemarks

El esquema que describe este elemento se encuentra en el directorio virtual de EWS del equipo que ejecuta Microsoft Exchange Server 2007 que tiene instalado el rol de servidor acceso de clientes.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.

EjemploExample

El siguiente ejemplo de una solicitud FindFolder muestra cómo crear una solicitud para buscar todas las carpetas que se encuentran en una bandeja 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>

Información del elementoElement information

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nombre de esquemaSchema Name
Esquema de mensajesMessages schema
Archivo de validaciónValidation File
Messages. xsdMessages.xsd
Puede estar vacíoCan be Empty
FalsoFalse

Vea tambiénSee also