2.2.3.81 FriendlyName

The FriendlyName element is an optional child element of the Set element in Settings command requests that specifies a name that MUST uniquely describe the client 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 friendly name of the device is a string that is meaningful to the user. The server does not validate this value. The FriendlyName element value can be up to 1024 characters in length.

The friendly name of the device is specified during partnership creation if the user creates a desktop-device partnership with a desktop. For more information about creating a desktop-device partnership, see [MSDN-ADDP].

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