Export (0) Print
Expand All

2.2.2.17 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 email addresses.

The Get (section 2.2.3.75) and Set (section 2.2.3.152) operations act on named properties. In the context of the Get and Set operations, each named property can contain a set of property-specific 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).

<Settings>
    <PropertyName>
        Data nodes
    </PropertyName>
    ...
</Settings>

The Settings command can be used on the following named properties:

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.<4>

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 5 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 call. The server will return responses in the same order in which they were requested.

Each response message contains a Status element (section 2.2.3.162.14) value for the command, which addresses the success or failure of the Settings command, followed by Status values for each of the changes made to the Oof, DeviceInformation, DevicePassword or UserInformation elements.

The Status node MUST indicate success if the Settings response contains property responses. If the command was not successful, the processing of the request cannot begin, no property responses are returned, and the Status node MUST indicate a protocol error.

Any error other than a protocol error is returned in the Status elements of the individual property responses. All property responses, regardless of the property, MUST contain a Status element to indicate success or failure. This Status node MUST be the first node in the property response.

The Settings namespace is the primary namespace for this section. Elements referenced in this section that are not defined in the Settings namespace use the namespace prefixes defined in section 2.2.1.

The following table lists the elements that are used in Settings command requests and responses.

Element name

Scope

Reference

Settings

Request and Response

section 2.2.3.153.2

RightsManagementInformation

Request and Response

section 2.2.3.143

Get

Request and Response

section 2.2.3.75

Oof

Request and Response

section 2.2.3.112

BodyType

Request and Response

section 2.2.3.17

Set

Request

section 2.2.3.152

OofState

Request and Response

section 2.2.3.114

StartTime

Request and Response

section 2.2.3.161.2

EndTime

Request and Response

section 2.2.3.58.2

OofMessage

Request and Response

section 2.2.3.113

AppliesToInternal

Request and Response

section 2.2.3.14

AppliesToExternalKnown

Request and Response

section 2.2.3.12

AppliesToExternalUnknown

Request and Response

section 2.2.3.13

Enabled

Request and Response

section 2.2.3.56

ReplyMessage

Request and Response

section 2.2.3.136

DevicePassword

Request and Response

section 2.2.3.46

Password

Request

section 2.2.3.122.3

DeviceInformation

Request and Response

section 2.2.3.45

Model

Request

section 2.2.3.105

IMEI

Request

section 2.2.3.82

FriendlyName

Request

section 2.2.3.74

OS

Request

section 2.2.3.117

OSLanguage

Request

section 2.2.3.118

PhoneNumber

Request

section 2.2.3.124

UserAgent

Request

section 2.2.3.175

EnableOutboundSMS

Request

section 2.2.3.57

MobileOperator

Request

section 2.2.3.103

UserInformation

Request and Response

section 2.2.3.177

Status

Response

section 2.2.3.162.14

Accounts

Response

section 2.2.3.5

Account

Response

section 2.2.3.2

AccountId

Response

section 2.2.3.3.2

AccountName

Response

section 2.2.3.4

UserDisplayName

Response

section 2.2.3.176

SendDisabled

Response

section 2.2.3.147

EmailAddresses

Response

section 2.2.3.54

SMTPAddress

Response

section 2.2.3.156

PrimarySmtpAddress

Response

section 2.2.3.127

The XML schema for the Settings command request is described in section 6.36. The XML schema for the Settings command response is described in section 6.37.

Protocol Versions

The following table specifies the protocol versions that support this command. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.4, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Command support

2.5

12.0

X

12.1

X

14.0

X

14.1

X

Show:
© 2015 Microsoft