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.

Order Client action Server action<br />

6 If the meeting was not declined, the client sends<br />

a Sync command for the calendar collection,<br />

specifying the GetChanges element.<br />

The server responds with any changes to the<br />

Calendar folder caused by the last<br />

synchronization and the new calendar item<br />

for the accepted meeting.<br />

3.1.5.6 Handling Status Errors<br />

The client MUST handle errors that occur during synchronization sessions. Errors fall into two<br />

categories: HTTP errors and <strong>ActiveSync</strong> protocol errors. HTTP errors are standard error codes, such<br />

as "401 Logon failed", and they are returned from the server in response to an HTTP POST.<br />

<strong>ActiveSync</strong> protocol errors result from a problem on the server, in an attempt to perform the task<br />

requested by the command request message. <strong>ActiveSync</strong> protocol errors are indicated by codes that<br />

are returned in the Status element (section 2.2.3.152) of a command response. For more details<br />

about the status codes, see section 2.2.4.<br />

The client MUST implement error handling and a user interface (UI). Some errors are handled by a<br />

recovery procedure. Other errors require that an error message be displayed, along with a prompt<br />

for the user to respond. The client determines whether to run a recovery procedure or prompt for<br />

user input.<br />

In addition to the <strong>ActiveSync</strong> protocol errors that the server sends, incomplete communication<br />

between server and client can result in the failure of a synchronization session. The server has an<br />

error recovery feature that enables a client to respond to errors by repeating the most recent<br />

synchronization session. The client MUST handle synchronization failures by retrying the<br />

synchronization. The server tracks synchronization requests to be able to respond appropriately in<br />

both of the following cases:<br />

•The client failed in communicating a full request to the server for synchronization.<br />

•In this case, the client sends a request but the server does not receive the request. The server<br />

does not act on the request, and no server-side changes occur. Therefore, no response is sent<br />

to the client. The client MUST resend a synchronization request if there is no immediate server<br />

response and neither the airsync:Wait element (section 2.2.3.171) nor the<br />

airsync:HeartbeatInterval element (section 2.2.3.75.2) was sent in the Sync request<br />

(section 2.2.2.19.1), or if the airsync:Wait element value or airsync:HeartbeatInterval<br />

element value was specified in the Sync request and the time has elapsed.<br />

•The server failed in communicating a response to the client for updates.<br />

•In this case, the server response is not received by the client. The client knows it has not<br />

received a response if neither the airsync:Wait element nor airsync:HeartbeatInterval<br />

element was sent in the Sync request and the server response is not received immediately, or<br />

if the airsync:Wait element value or the airsync:HeartbeatInterval element value was<br />

specified in the Sync request and that time has elapsed. The data on the server changed. The<br />

client MUST resend the request. The server recognizes the duplicate request. Because the<br />

server changes have already occurred, the server resends the response to the client to keep<br />

the server and client synchronized.<br />

3.1.6 Timer Events<br />

None.<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 />

271 / 369

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

Saved successfully!

Ooh no, something went wrong!