2.2.3.149 ReplyMessage

The ReplyMessage element is an optional child element of the OofMessage element in Settings command requests and responses that specifies the message to be shown to a particular audience when the user is OOF.

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 Oof request and response (section 2.2.1.18)

OofMessage (section 2.2.3.123)

None

string ([MS-ASDTYPE] section 2.7)

0...1 (optional)

The ReplyMessage element can be used in a Settings command Oof Get (section 2.2.3.83) response to convey the requested OOF message, or in a Settings command Oof Set request to set the message that the client wants to send to a particular audience. If a ReplyMessage element is included in an Oof Set request, a BodyType element (section 2.2.3.17) MUST also be included.

The Oof property (section 2.2.3.122) supports the following three audiences for an OOF message:

§ Internal—A user who is in the same organization as the sending user.

§ Known external—A user who is outside the sending user's organization, but is represented in the sending user's contacts.

§ Unknown external—A user who is outside the sending user's organization and is not represented in the sending user's contacts.

The presence of one of the following elements, which are mutually exclusive, indicates the audience to which an OOF message pertains:

§ AppliesToInternal—The OOF message is relevant to an internal audience.

§ AppliesToExternalKnown—The OOF message is relevant to a known external audience.

§ AppliesToExternalUnknown—The OOF message is relevant to an unknown external audience.

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