Compartir a través de

FindFolder

  • Artículo

El elemento FindFolder define una solicitud para buscar carpetas en un buzón.

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

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

FindFolderType

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
Traversal
 Define cómo se realiza una búsqueda. Este atributo es obligatorio.

Valores de atributos transversales

Valor Descripción
Superficial
 Indica a la operación FindFolder que busque solo la carpeta identificada y que devuelva solo los identificadores de carpeta de los elementos que no se han eliminado. Esto se denomina recorrido superficial.
Profundo
 Indica a la operación FindFolder que busque en todas las carpetas secundarias de la carpeta primaria identificada y que devuelva solo los identificadores de carpeta de los elementos que no se han eliminado. Esto se denomina recorrido profundo.
SoftDeleted
 Indica a la operación FindFolder que realice una búsqueda transversal superficial de elementos eliminados.

Elementos secundarios

Elemento Descripción
FolderShape
Identifica las propiedades de carpeta que se van a incluir en una respuesta FindFolder.
IndexedPageFolderView
Describe cómo se devuelve la información del elemento paginado en una respuesta FindFolder. Este elemento es opcional.
FractionalPageFolderView
Describe dónde se inicia la vista paginada y el número máximo de carpetas devueltas en una solicitud FindFolder. Este elemento es opcional.
Restriction
Define una restricción o consulta que se usa para filtrar carpetas en una operación FindFolder. Este elemento es opcional.
ParentFolderIds
Identifica las carpetas de la operación FindFolder que se va a buscar.

Elementos principales

Ninguno.

Comentarios

El esquema que describe este elemento se encuentra en el directorio virtual EWS del equipo que ejecuta Microsoft Exchange Server 2007 que tiene instalado el rol de servidor acceso de cliente.

Ejemplo

En el ejemplo siguiente de una solicitud FindFolder se muestra cómo formar una solicitud para buscar todas las carpetas ubicadas en una bandeja de entrada.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindFolder Traversal="Shallow" xmlns="http://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 elemento

Elemento Ejemplo
Namespace
 http://schemas.microsoft.com/exchange/services/2006/messages
Nombre de esquema
 Esquema de mensajes
Archivo de validación
 Messages.xsd
Puede estar vacío
 False

Vea también