[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

If the message was sent successfully, the server returns an empty response.
HTTP/1.1 200 OK
Date: Thu, 03 Sep 2009 21:05:44 GMT
Content-Length: 0
2.2.2.16 Settings
The Settings command supports get and set operations on global properties and Out of Office
(OOF) settings for the user. The Settings command also sends device information to the server,
implements the device password/personal identification number (PIN) recovery, and retrieves a list
of the user's e-mail addresses.
The Get (section 2.2.3.71) and Set (section 2.2.3.142) operations act on named properties. In
the context of the Get and Set operations, each named property can contain a set of propertyspecific
data nodes.
The Settings command can contain multiple Get and Set requests and responses in any order. The
implication of this batching mechanism is that commands are executed in the order in which they
are received and that the ordering of Get and Set responses will match the order of those
commands in the request.
The following is the generic form of the Settings request, where "PropertyName" is a named
property (that is, the actual name of the property).
Data nodes
...
The Settings command can be used on the following named properties:
•OOF (section 2.2.3.104)
•DevicePassword (section 2.2.3.44)
•DeviceInformation (section 2.2.3.43)
•UserInformation (section 2.2.3.165)
Clients SHOULD send DeviceInformation parameters in a Set block to the server as soon as the
client has been provisioned, and before the FolderSync command (section 2.2.2.4), so that the
server can use this information to determine what the device has access to.
The argument or data nodes are Get or Set, which can also have their own arguments. It is up to
the individual property handlers to parse and interpret them as necessary.
It is possible to have between 0 (zero) and 4 "PropertyName" elements in a Settings request (that
is, each of the four named properties can appear zero or one time in a request). Each property
MUST be processed in order. There can be cases in which one property call affects another property
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011
68 / 369