[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

•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, the
server responds with a Status element (section 2.2.3.152.12) value of 8 (SearchTooComplex).
2.2.3.26.5 Class (Sync)
The Class element is an optional child element of the Add element or the Options element in Sync
command requests. The Class element is an optional child element of the Delete element, the
Change element, or the Add element in Sync command responses.
All elements referenced in this section are defined in the AirSync namespace.
Command
request/response
Parent elements
Child
elements
Data type
Number
allowed
Sync command request
(section 2.2.2.19.1)
Add (section
2.2.3.7.2)
Options (section
2.2.3.107.5)
None
string ([MS-
ASDTYPE] section
2.6)
0...1
(optional)
Sync command response
(section 2.2.2.19.2)
Delete
(section 2.2.3.40.2)
Change (section
2.2.3.23)
Add (section
2.2.3.7.2)
None string 0...1
(optional)
As a child element of the Add element in the Sync command request, the Class element
identifies the class of the item being added to the collection.
As a child element of the Options element in the Sync command request, the Class element
assigns the filters within the Options container to a given class. Options for the same Class within
the same Collection (section 2.2.3.28.2) MUST NOT be redefined. A Status element (section
2.2.3.152.16) value of 4 is returned if options for the same Class within the same Collection are
redefined. The Class element is not necessary for the default items contained within the collection
(contacts in a contacts folder for example). For example, to sync SMS messages, include an
Options node with class "SMS". To also sync e-mail messages at the same time, include another
Options node with class "Email". Only SMS messages and e-mail messages can be synchronized at
the same time; a request for any other combination of classes will fail with a status value of 4. The
result of including more than one Class element as child elements of the Options element is
undefined. The server MAY return a protocol status error in response to such a command request.
As a child element of the Delete element in the Sync command response, the Class element
identifies the class of the item being deleted from the collection.
As a child element of the Change element in the Sync command response, the Class element
identifies the class of the item being changed in the collection.
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011
116 / 369