2.2.2.53 settings:DeviceInformation

  • Artykuł

The settings:DeviceInformation element is an optional container ([MS-ASDTYPE] section 2.2) element that is used for sending the client device's properties to the server in an initial Provision command request. It is a child of the Provision element (section 2.2.2.44). The settings:DeviceInformation element is defined in the Settings XML namespace, as specified in [MS-ASCMD] section 2.2.3.45.

When the Provision command is used to send the settings:DeviceInformation element, it sends the information about the client device to the server, as specified for the settings:DeviceInformation element under the Settings command in [MS-ASCMD] section 2.2.1.18.

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

12.1

14.0

14.1

Yes

16.0

Yes

16.1

Yes

When protocol version 14.1, 16.0, or 16.1 is used, the client MUST send the settings:DeviceInformation element with its contents when sending an initial Provision command request to the server but not on subsequent requests. The settings:DeviceInformation element MUST contain a settings:Set child element ([MS-ASCMD] section 2.2.3.167), and the settings:Set element MUST at least contain a settings:Model child element ([MS-ASCMD] section 2.2.3.115).

When protocol version 14.0, 12.1, or 12.0 is used, the client MUST NOT send the settings:DeviceInformation element in any Provision command request. In these cases, the settings:DeviceInformation element can be used in a Settings command request, as specified in [MS-ASCMD] section 3.1.5.2.

Protocol version 2.5 does not support sending device information to the server.