[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

•Sync command requests (section 2.2.2.19.1)
The definition of the MaxItems element differs according to the context in which it is used. For
more details, see section 2.2.3.87.1 and section 2.2.3.87.2.
2.2.3.87.1 MaxItems (GetItemEstimate)
The airsync:MaxItems element is an optional child element of the airsync:Options element
in GetItemEstimate command requests that specifies the maximum number of items to include in
the response. This element can only be included in a request when the CollectionId element
(section 2.2.3.29.1) is set to "RI" to specify a recipient information store; otherwise, the server will
respond with a status 2 error. The value of the airsync:MaxItems element does not specify the
limit of estimates available; rather, it only specifies the number of items, as a complete replacement
would be double the number of items in the store (n deletes plus n additions).
Elements referenced in this section are defined in the GetItemEstimate 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
GetItemEstimate command
request (section 2.2.2.7.1)
airsync:Options
(section 2.2.3.107.1)
None
integer ([MS-
ASDTYPE]
section 2.5)
0...1
(optional)
Including airsync:MaxItems when the CollectionId element is set to anything other than "RI"
results in an invalid XML error, Status element (section 2.2.3.152.6) value of 2.
The result of including more than one airsync:MaxItems element as the child of the
airsync:Options element is undefined. The server MAY return a protocol status error in response to
such a command request.
2.2.3.87.2 MaxItems (Sync)
The MaxItems element is an optional child element of the Options element in Sync
command requests that specifies the maximum number of recipients (that is, the top N most
frequently used recipients) to keep synchronized from within the recipient information cache. This
element MUST only be included in a request when the value of the CollectionId element (section
2.2.3.29.5) maps to the recipient information cache. The value of the MaxItems element does not
specify the maximum estimate of additions and deletions to make to the recipient information
cache, it only specifies the number of recipients to keep synchronized. A complete replacement of
each recipient would be double the number of MaxItems or items in the store, as each recipient
update requires a deletion and an addition.
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)
Options (section
2.2.3.107.5)
None
integer ([MS-
ASDTYPE] section
2.5)
0...1
(optional)
163 / 369
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011