2.2.2.16 Categories

The Categories element is an optional container ([MS-ASDTYPE] section 2.2) element that specifies a collection of user-selected categories assigned to the e-mail message. It is defined as an element in the Email namespace.

The Categories element can contain the following child element:

  • Category (section 2.2.2.17): This element is optional.

An empty Categories element is included as a child of the Add ([MS-ASCMD] section 2.2.3.7.2) element in a Sync ([MS-ASCMD] section 2.2.1.21) command if no child Category elements have been set on the message. A Sync command that contains a Change element ([MS-ASCMD] section 2.2.3.24) that contains an empty Categories element indicates that all categories associated with the message have been removed. A Sync command that contains a Change element that does not contain a Categories element indicates that the categories on the message have not changed.

Protocol Versions

The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Element support

2.5

12.0

12.1

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

Show: