2.2.3.45 DeviceInformation

The DeviceInformation element is an optional child element of the Settings element in Settings command requests and responses, and an optional child element of the Provision element in Provision command requests. In Settings and Provision command requests, it is a container node that is used for sending the client device's properties to the server. In Settings command responses, it is a container node that is used to return the status of the request.

All elements referenced in this section are defined in the Settings namespace.

Command request/response

Parent elements

Child elements

Data type

Number allowed

Settings command request (section 2.2.1.18)

Settings (section 2.2.3.168.2)

Set (section 2.2.3.167)

container ([MS-ASDTYPE] section 2.2)

0...1 (optional)

Settings command response

Settings

Status (section 2.2.3.177.15)

container

0...1 (optional)

Provision command request ([MS-ASPROV] section 2.2)

Provision ([MS-ASPROV] section 2.2.2.44)

Set

container

0...1 (optional)

If the protocol version is not 14.1, the client uses the Settings command to send DeviceInformation to the server, as specified in section 3.1.5.2. More details about the protocol versions are provided at the end of this section.

The DeviceInformation element allows the following information about a client device to be sent to the server:

§ Device model

§ International Mobile Equipment Identity (IMEI)

§ Device friendly name

§ Device operating system

§ Telephone number

§ Device operating system language

§ User Agent

§ Whether to enable outbound SMS (see [MS-ASMS])

§ Mobile operator name

The device information is represented as a list of settings under the DeviceInformation node in the Settings command request and the Provision command request. The DeviceInformation element has only one child element, Set, which contains the list of device information items in the request and the status in the response. The DeviceInformation element supports only the Set element because the device information is write-only from the device.

Protocol Versions

The following table specifies the protocol versions that support this element. 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.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Element support, Settings

Element support, Provision

2.5

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

Yes

16.0

Yes

Yes

16.1

Yes

Yes

When protocol version 14.1, 16.0, or 16.1 is used, the DeviceInformation element MUST be present as a child element of the Provision element in the initial Provision command request. When protocol version 14.0, 12.1, or 12.0 is used, the DeviceInformation element MUST NOT be present as a child element of the Provision element in the initial Provision command request. In this case, the client uses the Settings command to send the device's properties to the server.

Show: