[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

2.2.3.107.5 Options (Sync)
The Options element is an optional child element of the Collection element in Sync command
requests that contains elements that control certain aspects of how the synchronization is
performed.
Elements referenced in this section are defined in the AirSync namespace, except where otherwise
indicated by the presence of a namespace prefix (as defined in section 2.2.1).
Command
request/response
Parent
elements Child elements Data type
Number
allowed
Sync command
request (section
2.2.2.19.1)
Collection
(section
2.2.3.28.2)
FilterType (section 2.2.3.61.2)
Conflict (section 2.2.3.32)
MIMETruncation (section 2.2.3.95)
MIMESupport (section 2.2.3.94.3)
Class (section 2.2.3.26.5)
MaxItems (section 2.2.3.87.2)
airsyncbase:BodyPreference
airsyncbase:BodyPartPreference
rm:RightsManagementSupport
([MS-ASRM] section 2.2.2.1)
container
([MS-
ASDTYPE]
section
2.2)
0...2
(optional)
This element is optional, but if it is present, it SHOULD include at least one child element. The
Options element appears only in requests to the server from the client.
Synchronization options enable the client to specify truncation and content settings. These settings
are encapsulated within a airsyncbase:BodyPreference node within the Options element as
follows:
1
512
1
255
Because synchronization options are specified on a collection, the client can specify a unique
airsyncbase:BodyPreference element value for each collection that it is being synchronized. For
more details about the airsyncbase:BodyPreference element, see [MS-ASAIRS] section 2.2.2.2.
The server preserves the Options block across requests, using a concept referred to as "sticky
options". If the Options block is not included in a request, the previous Options block is used.
Whenever the client specifies new options by including an Options block in the request, the server
MUST replace the original Options block with the new Options block.
The following example Options element specifies that items in the collection that are older than
three days SHOULD NOT be returned to the client, that items MUST be truncated to 512 characters
if they are larger, and that, if there are any item conflicts, the server MUST replace the client items.
Request
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011
184 / 369