2.2.3.16 Availability
The Availability element is an optional child element of the Options element in ResolveRecipients command requests that indicates to the server that free/busy data is being requested by the client and identifies the start time and end time of the free/busy data to retrieve. The Availability element is an optional child element of the Recipient element in ResolveRecipient command responses that returns the status and free/busy data of the users or distribution lists identified in the request for the time identified by the StartTime and EndTime elements.
All elements referenced in this section are defined in the ResolveRecipients namespace.
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
ResolveRecipients command request (section 2.2.1.15) |
Options (section 2.2.3.125.4)
|
StartTime (section 2.2.3.176.1) EndTime (section 2.2.3.61.1) |
container ([MS-ASDTYPE] section 2.2) |
0...1 (optional) |
|
ResolveRecipients command response |
Recipient (section 2.2.3.145) |
Status (section 2.2.3.177.12) MergedFreeBusy (section 2.2.3.107) |
container |
0...1 (optional) |
When the Availability element is included in a ResolveRecipients request, the server retrieves free/busy information for the users identified in the To elements included in the request, and returns the free/busy information in the MergedFreeBusy element in the response. If the Availability element is included in the ResolveRecipients request, the request MUST also include a valid StartTime element value. When the server parses the request, the server first resolves the recipients identified by the To elements, and then determines the users free/busy information for the specified time span, before returning the free/busy data in the MergedFreeBusy element.
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 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |