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 |
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.