2.2.3.25 Changes

The Changes element is an optional child element of the FolderSync element in FolderSync command responses that contains changes to the folder hierarchy. It is used to update the client with folder additions, deletions, and updates on the server.

All elements referenced in this section are defined in the FolderHierarchy namespace.

Command request/response

Parent elements

Child elements

Data type

Number allowed

FolderSync command response (section 2.2.1.5)

FolderSync (section 2.2.3.76)

Count (section 2.2.3.37)

Update (section 2.2.3.187)

Delete (section 2.2.3.42.1)

Add (section 2.2.3.7.1)

container ([MS-ASDTYPE] section 2.2)

0…1 (optional)

The server SHOULD maintain the same set of folder data being returned across synchronization key 0 (zero), in terms of ServerId (section 2.2.3.166.4) and DisplayName (section 2.2.3.49.4) mapping. While the server SHOULD maintain this mapping, clients MUST be able to handle having the server return a completely different set of mapped data.

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

Yes

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes