2.2.3.27.5 Class (Search)

The airsync:Class element is an optional child element of the And element and the Schema element in Search command requests and an optional child element of the Result element in Search command responses. In all contexts, it specifies the classes that the client wants returned for a given collection.

Elements referenced in this section are defined in the Search namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).

Command request/response

Parent elements

Child elements

Data type

Number allowed

Search command request (section 2.2.1.16)

And (section 2.2.3.10)

Schema

None

string ([MS-ASDTYPE] section 2.7)

0...N (optional)

Search command response

Result (section 2.2.3.155.3)

None

string

0…1 (optional)

The valid airsync:Class element values are as follows for the latest protocol version. Details about the protocol versions are provided at the end of this section.

§ Tasks

§ Email

§ Calendar

§ Contacts

§ Notes

§ SMS

The Search request can include one or more airsync:Class elements in the request to limit the type of data included in the Search response. If one or more airsync:Class elements are not included in the Search request, the server will return all supported classes.

If the airsync:Class element is included as a child of any element other than the And element in the request, the server responds with a Status element (section 2.2.3.177.13) value of 8 (SearchTooComplex).

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

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

The "SMS" and "Notes" values are valid only when the protocol version being used is 14.0, 14.1, 16.0, or 16.1. The values "Tasks", "Email", "Calendar", and "Contacts" are valid for protocol versions 12.0, 12.1, 14.0, 14.1, 16.0, and 16.1.

Show: