Partager via


SearchFolder

Last modified: March 16, 2009

Applies to: Exchange Server 2007 | Exchange Server 2010

The SearchFolder element represents a search folder that is contained in a mailbox.

<SearchFolder>
   <FolderId/>
   <ParentFolderId/>
   <FolderClass/>
   <DisplayName/>
   <TotalCount/>
   <ChildFolderCount/>
   <ExtendedProperty/>
   <ManagedFolderInformation/>
   <UnreadCount/>
   <SearchParameters/>
   <PermissionSet/>
      <EffectiveRights/>
</SearchFolder>

SearchFolderType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element

Description

FolderId

Contains the identifier and change key of a folder.

ParentFolderId

Represents the identifier of the parent folder that contains the folder.

FolderClass

Represents the folder class for a given folder.

DisplayName

Contains the display name of a folder.

TotalCount

Represents the total count of items within a given folder.

ChildFolderCount

Represents the number of child folders contained within a folder. This property is read-only.

ExtendedProperty

Identifies extended properties on folders.

ManagedFolderInformation

Contains information about a managed folder.

UnreadCount

Represents the count of unread items within a given folder.

SearchParameters

Contains the parameters that define a search folder.

PermissionSet (PermissionSetType)

Contains all the configured permissions for a folder. This element was introduced in Microsoft Exchange Server 2007 Service Pack 1 (SP1).

EffectiveRights

Contains the client’s rights based on the permission settings for the item or folder. This element is read-only. This element was introduced in Exchange 2007 SP1.

Parent Elements

Element

Description

AppendToFolderField

Specifies data to append to a folder property during an UpdateFolder Operation.

Create (FolderSync)

Identifies a single folder to create in the local client store.

SetFolderField

Represents an update to a single property on a folder in an UpdateFolder Operation.

Update (FolderSync)

Identifies a single folder to update in the local client store.

Folders

Contains an array of folders used in folder operations.

Remarks

SearchFolder is used for both regular search folders and MicrosoftOfficeOutlook and Outlook Web Access visible search folders. For a search folder to be visible to Outlook and Outlook Web Access, the folder must be created under the SearchFolders distinguished folder.

The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/types

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False

See Also

Other Resources