11.01.2015 Views

[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

In order to synchronize the content of each of the folders, an initial synchronization key for each<br />

folder MUST be obtained from the server. The client obtains the key by sending the server an initial<br />

Sync request (section 2.2.2.19.1) with a airsync:SyncKey element (section 2.2.3.156.4) value of<br />

zero (0) and the airsync:CollectionId element (section 2.2.3.29.5) value that identifies the folder<br />

to be synchronized. The Sync command response (section 2.2.2.19.2) includes a new<br />

airsync:SyncKey value, which is generated by the server for each transaction.<br />

Figure 5: Retrieval of SyncKey value<br />

The airsync:SyncKey issued in the initial Sync response MUST be stored by the client, and is sent<br />

in the second Sync request. The second Sync request includes the new airsync:SyncKey element<br />

as well as the airsync:GetChanges (section 2.2.3.72) element.<br />

Figure 6: Retrieval of folder content<br />

The server responds by adding all the items in the collection to the client and returning a new<br />

airsync:SyncKey element value, which can be used in successive synchronizations. The client<br />

deletes its copy of all objects in the collection that are being synchronized before the client performs<br />

a full synchronization. The client can use the GetItemEstimate command (section 2.2.2.7) to<br />

obtain an estimate of the number of items that have to be synchronized before completely<br />

synchronizing a collection, which is useful when the client user interface displays a progress bar<br />

while getting items from the server. In some cases, the client could have to submit a<br />

[<strong>MS</strong>-<strong>ASCMD</strong>] — v20110315<br />

<strong>ActiveSync</strong> <strong>Command</strong> <strong>Reference</strong> <strong>Protocol</strong> <strong>Specification</strong><br />

Copyright © 2011 Microsoft Corporation.<br />

Release: Tuesday, March 15, 2011<br />

268 / 369

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!