DistinguishedGroupBy

Topic Last Modified: 2007-05-15

The DistinguishedGroupBy element provides standard groupings for FindItem queries.

Schema Hierarchy

FindItem
  DistinguishedGroupBy

Syntax

<DistinguishedGroupBy>
   <StandardGroupBy/>
</DistinguishedGroupBy>

Type

DistinguishedGroupByType

Attributes and Elements

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

Attributes

None.

Child Elements

Element Description

StandardGroupBy

Represents the standard grouping and aggregating mechanisms for a grouped FindItem operation.

Parent Elements

Element Description

FindItem

Defines a request to find items in a mailbox.

The following is the XPath expression to this element: /FindItem

Remarks

The DistinguishedGroupBy element can be added to a FindItem operation when the results must come backed grouped and when one of the standard groups meets the grouping requirements. If neither the DistinguishedGroupBy element nor the GroupBy element is specified, FindItem results will come back ungrouped.

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.

Element Information

Namespace

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

Schema Name

Messages schema

Validation File

Messages.xsd

Can be Empty

False

See Also

Reference

FindItem Operation

Other Resources

Finding Items (Exchange Web Services)