[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

The Range element value specifies a number of entries, but indicates different things depending on
whether the element is in the request or the response XML.
The format of the Range element value is in the form of a zero-based index specifier, formed with a
zero, a hyphen, and another numeric value: "m-n." The m indicates the lowest index of a zerobased
array that would hold the items. The n indicates the highest index of a zero-based array that
would hold the items. For example, a Range element value of 0–9 indicates 10 items, and 0–10
indicates 11 items. A Range element value of 0–0 indicates 1 item.
If the request does not include a Range element, the default Range value for each Store type is
used. The following table identifies the default Range values and maximum results returned for each
Store type:
Store value Default Range value Maximum results returned
Mailbox 0-99 100
DocumentLibrary 0-999 1000
GAL 0-99 100
If the Range element value specified in the request exceeds the default range value, a Status
element (section 2.2.3.152.12) value of 12 is returned to indicate that the maximum range has
been exceeded, as specified in section 2.2.3.152.12.
In the Search command response, the Total element (section 2.2.3.158.2) indicates an estimate of
the total number of entries that matched the Query element (section 2.2.3.119) value.
Search results are stored in a search folder (2) on the server. This way, when a client comes back
with the same query but a new row range, rows are pulled from the result set that is currently
stored in the search folder. The entire result set does not have to be rebuilt.
2.2.3.121 RebuildResults
The RebuildResults element is an optional child element of the Options element in Search
command requests that forces the server to rebuild the search folder (2) that corresponds to a given
query.
All elements referenced in this section are defined in the Search namespace.
Command request/response
Parent elements
Child
elements
Data
type
Number
allowed
Search command request (section
2.2.2.14.1)
Options (section
2.2.3.107.4)
None None 0...1
(optional)
The RebuildResults element is an empty tag element, meaning it has no value or data type. It is
distinguished only by the presence or absence of the tag.
The result of including more than one RebuildResults element in a Search command request is
undefined. The server MAY return a protocol status error in response to such a command request.
The search results (that is, the result set) are stored in a search folder on the server. This way,
when a client comes back with the same query but a new row range, rows are pulled from the result
set that is currently stored in the search folder. The entire result set does not have to be rebuilt.
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011
195 / 369