2.2.3.183 To
The To element is a required child element of the ResolveRecipients element in ResolveRecipients command requests that specifies one or more recipients to be resolved. The To element is a required child element of the Response element in ResolveRecipients command responses that specifies a recipient to be resolved. The To element is an ANR search field. Its value can be up to 256 characters in length.
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) |
ResolveRecipients (section 2.2.3.152)
|
None |
string ([MS-ASDTYPE] section 2.7) |
1...100 (required) |
|
ResolveRecipients command response |
Response (section 2.2.3.153.6) |
None |
string |
1…1 (required) |
The result of including more than 100 To elements in the request is undefined. The server SHOULD<17> return a protocol status error in response to such a command request.
If the To element specifies an ambiguous name and the Availability element (section 2.2.3.16) is included in the request, the response will not include free/busy data for that user. The Availability element is only included when the To element includes a valid SMTP address or name that resolves to a unique individual on the server.
The server attempts to match the To element value specified in the request to common directory service user attributes, and then return the matches. The To element(s) that are returned in the response corresponds directly to the To element(s) that are specified in the request.<18>
If the ResolveRecipients command request includes the Availability element, the number of exactly matched recipients cannot exceed the maximum number.<19> If the number of exactly matched recipients exceeds the maximum number, Status element (section 2.2.3.177.12) value 160 is returned in the response.
If the ResolveRecipients command request includes the Availability element and includes a To element for an ambiguous user, the response does not include a MergedFreeBusy element (section 2.2.3.107) for that user. Only users or distribution lists specified with valid SMTP addresses or a uniquely identifiable string in the request message To element have MergedFreeBusy elements included in the response.
If the ResolveRecipients command request includes the Availability element and the To element specifies a distribution group, then the availability data is returned as a single string that merges the data for the individual members of the distribution group. If the distribution group contains more than 20 members, a Status element value of 161 is returned in the response indicating that the merged free busy information of such a large distribution group is not useful. For more information about the Status element, see section 2.2.3.177.12.
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 |
Yes |
|
12.0 |
Yes |
|
12.1 |
Yes |
|
14.0 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |