2.2.3.97 Limit

The Limit element is an optional child element of the Sync element in Sync command responses that specifies either the maximum number of collections that can be synchronized or the maximum/minimum value that is allowed for the Wait interval (section 2.2.3.198) or HeartbeatInterval interval (section 2.2.3.88.2).

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 response (section 2.2.1.21)

Sync (section 2.2.3.180)

None

integer ([MS-ASDTYPE] section 2.6)

0...1 (optional)

The Limit element is returned in a response with a status code of 14 or 15. The value of the Status element (section 2.2.3.177.17) indicates whether the limit applies to the Wait interval or HeartbeatInterval interval or the number of collections, as follows:

  • A status code 14 indicates that the Limit element specifies the minimum or maximum wait-interval that is acceptable. When the value of the Wait element or HeartbeatInterval element is outside of the acceptable range, the server responds with the closest acceptable value. If a Wait element value of less than 1 is sent, the server returns a Limit element value of 1, indicating the minimum value of the Wait element is 1. If a Wait element value greater than 59 is sent, the server returns a Limit element value of 59, indicating the maximum value of the Wait element is 59. If a HeartbeatInterval element value of less than 60 is sent, the server returns a Limit element value of 60, indicating the minimum value of the HeartbeatInterval element is 60. If a HeartbeatInterval element value greater than 3540 is sent, the server returns a Limit element value of 3540, indicating the maximum value of HeartbeatInterval element is 3540.

  • A status code 15 indicates that the Limit element specifies the maximum number of collections that can be synchronized.

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

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

Show: