SearchFolder
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 (string) |
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
| Element | Example |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/types |
| Schema Name |
Types schema |
| Validation File |
Types.xsd |
| Can be Empty |
False |