2.2.3.104.2 MaxPictures (ResolveRecipients)
The MaxPictures element is an optional child element of the Picture element in ResolveRecipients command requests that limits the number of contact photos returned in the server response.
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) |
Picture (section 2.2.3.135.2) |
None |
integer ([MS-ASDTYPE] section 2.6) |
0…..1 (optional) |
The value of the MaxPictures element MUST NOT be less than 0.
The server returns the first N results that have contact photos, where N is the value of the MaxPictures element. After the MaxPictures limit is reached, the server returns Status element (section 2.2.3.177) value 173 (NoPicture) if the contact has no photo, Status element value 174 (PictureTooLarge) if the contact’s photo is too large, or Status element value 175 (PictureLimitReached) if the contact has a photo but the MaxPictures limit was reached.
Note that the MaxPictures element identifies the number of contact photos returned per query. Therefore, if the client includes three recipients to resolve and sets the MaxPictures element value to 3 in the ResolveRecipients command request, a maximum of 9 contact photos can be returned.
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 |
|
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |