2.2.3.91 IMEI

The IMEI element is an optional child element of the Set element in Settings command requests that specifies a 15-character code that MUST uniquely identify a device.

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 DeviceInformation request (section 2.2.1.18)

Set  (section 2.2.3.167)

None

string ([MS-ASDTYPE] section 2.7)

0...1 (optional)

The IMEI element value can be up to 1024 characters in length. The server does not validate the format of the IMEI element value.

The device ID parameter that is currently included in the request URL is not precisely defined; protocol implementers are free to populate the field as they want. To enable workable inventory-type report generation, an ID that uniquely identifies a device in the space of all devices is required. The IMEI element satisfies this requirement.

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

2.5

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes