2.2.3.83 Get

The Get element is a required child element of the RightsManagementInformation element in Settings command RightsManagementInformation requests and responses, an optional child element of the Oof element in Settings command Oof requests and responses, and a required child element of the UserInformation element in Settings command UserInformation requests and responses.

In requests, the Get element enables the client to retrieve rights management information settings, OOF settings, or user information settings from the server. In responses, the Get element contains rights management information settings, OOF information, or user information settings retrieved from the server.

Elements referenced in this section are defined in the Settings namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).

Command request/response

Parent elements

Child elements

Data type

Number allowed

Settings command RightsManagementInformation request (section 2.2.1.18)

RightsManagementInformation (section 2.2.3.156)

None

None

1…1 (required)

Settings command RightsManagementInformation response

RightsManagementInformation

rm:RightsManagementTemplates ([MS-ASRM] section 2.2.2.17)

container ([MS-ASDTYPE] section 2.2)

1…1 (required)

Settings command Oof request

Oof (section 2.2.3.122)

BodyType (section 2.2.3.17)

container

0…1 (optional)

Settings command Oof response

Oof

OofState (section 2.2.3.124)

StartTime (section 2.2.3.176.2)

EndTime (section 2.2.3.61.2)

OofMessage (section 2.2.3.123)

container

0...1 (optional)

Settings command UserInformation request

UserInformation (section 2.2.3.192)

None

None

1…1 (required)

Settings command UserInformation response

UserInformation

EmailAddresses (section 2.2.3.57)

Accounts (section 2.2.3.5)

container

1…1 (required)

In a Settings command Oof request, the client specifies the body type (BodyType element) to be retrieved and the server will return all OOF settings and messages for that body type.

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, child of Oof, UserInformation

Element support, child of RightsManagementInformation

2.5

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

Yes

16.0

Yes

Yes

16.1

Yes

Yes

The EmailAddresses element is supported as a child element of the Get element only when the protocol version 12.0, 12.1 or 14.0 is used.

The RightsManagementInformation element is supported as a parent element of the Get element only when the protocol version 14.1, 16.0, or 16.1 is used.

Show: