SearchFolder

Article
03/29/2023

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	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False