[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

•FolderDelete command requests (section 2.2.2.3.1) and responses (section 2.2.2.3.2)
•FolderUpdate command requests (section 2.2.2.5.1) and responses (section 2.2.2.5.2)
•FolderSync command requests (section 2.2.2.4.1) and responses (section 2.2.2.4.2)
•GetItemEstimate command requests (section 2.2.2.7.1)
•Sync command requests (section 2.2.2.19.1) and responses (section 2.2.2.19.2)
The definition of the SyncKey element differs according to the context in which it is used. For more
details, see section 2.2.3.156.1, section 2.2.3.156.2, section 2.2.3.156.3, section 2.2.3.156.4.
2.2.3.156.1 SyncKey (FolderCreate, FolderDelete, and FolderUpdate)
The SyncKey element is a used in FolderCreate command requests and responses, FolderDelete
command and responses, and FolderUpdate command and responses to represent the
synchronization state of a collection.
All elements referenced in this section are defined in the FolderHierarchy namespace.
Command
request/response
Parent elements
Child
elements
Data type
Number
allowed
FolderCreate command
request (section 2.2.2.2.1)
FolderCreate
(section 2.2.3.63)
None
string ([MS-
ASDTYPE] section
2.6)
1…1
(required)
FolderCreate command
response (section 2.2.2.2.2)
FolderCreate None string 0...1
(optional)
FolderDelete command
request (section 2.2.2.3.1)
FolderDelete
(section 2.2.3.64)
None string 1…1
(required)
FolderDelete command
response (section 2.2.2.3.2)
FolderDelete None string 0...1
(optional)
FolderUpdate command
request (section 2.2.2.5.1)
FolderUpdate
(section 2.2.3.68)
None string 1…1
(required)
FolderUpdate command
response (section 2.2.2.5.2)
FolderUpdate None string 0…1
(optional)
The server returns a Status element (section 2.2.3.152.5) value of 10 if the SyncKey element is
not included in a FolderUpdate command request.
After a successful FolderCreate command (section 2.2.2.2), FolderDelete command (section
2.2.2.3), or FolderUpdate command (section 2.2.2.5), the server MUST send a synchronization key
to the client in a response. If the FolderCreate command, FolderDelete command, or
FolderUpdate command is not successful, the server MUST NOT return a SyncKey element.
The client MUST store this key and send it back to the server the next time the folder hierarchy is
synchronized or updated. The server MUST check the value of the key to make sure the value of the
SyncKey element provided in the request matches a synchronization key value on the server. The
server MUST return a Status element (section 2.2.3.152.4) value of 9 if the value of the SyncKey
element does not match the value of the synchronization key on the server.
The client MUST store the synchronization key as an opaque string of up to 64 characters.
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011
244 / 369