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.

Element Scope <strong>Reference</strong><br />

ClientId Request and Response section 2.2.3.27.2<br />

Fetch Request and Response section 2.2.3.60.2<br />

Wait Request section 2.2.3.171<br />

HeartbeatInterval Request section 2.2.3.75.2<br />

Partial Request section 2.2.3.112<br />

Status Response section 2.2.3.152.16<br />

Limit Response section 2.2.3.82<br />

SoftDelete Response section 2.2.3.147<br />

Responses Response section 2.2.3.131<br />

MoreAvailable Response section 2.2.3.99<br />

For more details about the AirSyncBase elements that are used by this command, see [<strong>MS</strong>-<br />

ASAIRS] section 2.2.<br />

Synchronization requires a priming of the system; therefore for each collection that the client wishes<br />

to synchronize, it MUST issue an initial Sync request by sending a synchronization key of 0 (zero).<br />

This request establishes a synchronization relationship with the server and initializes the<br />

synchronization state there. The server responds with an initial value of the synchronization key,<br />

which the client MUST then use to get the initial set of objects from the server. (From this point<br />

forward, client requests MUST always include the synchronization key that was received in the last<br />

response from the server.) The client then sends a Sync command request to the server with the<br />

response synchronization key and includes any changes that were made on the client.<br />

If the client device has not yet synchronized a folder, there SHOULD be no client-side changes. The<br />

device MUST synchronize the full contents of a given folder, and then have its changes, additions,<br />

and deletions applied.<br />

The response from the server indicates whether the client's changes were accepted, and includes<br />

any changes that were made on the server. The server response also contains a synchronization key<br />

that is to be used for the next synchronization session for the folder.<br />

This protocol has been optimized for the case in which there are no changes to any of the collections<br />

that are specified in the Sync request. In such a case, the client can receive an empty response<br />

from the server. After the client receives an empty response, the client can issue an empty Sync<br />

request. The server then re-executes the previous request, which it cached.<br />

Certain <strong>ActiveSync</strong> classes support ghosted properties. A ghosted property whose value has not<br />

changed from the last Sync response can be excluded from the request body, and its value on the<br />

server will be preserved instead of being deleted. A client uses the Supported element to specify to<br />

the server which properties are managed by the client and not ghosted by the server. For more<br />

information, see section 2.2.3.154.<br />

The following diagram shows request and response processing by the client.<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 />

82 / 369

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

Saved successfully!

Ooh no, something went wrong!