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
§ Calendar
§ Contacts
§ Notes
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.