[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

The result of including more than one MaxItems element as the child element of the Options
element is undefined. The server MAY return a protocol status error in response to such a command
request.
2.2.3.88 MaxPictures
The MaxPictures element is used in the following command requests:
•ResolveRecipients command requests (section 2.2.2.13.1)
•Search command requests (section 2.2.2.14.1)
The definition of the MaxPictures element differs according to the context in which it is used. For
more details, see section 2.2.3.87.1 and section 2.2.3.87.2.
2.2.3.88.1 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.2.13.1)
Picture (section
2.2.3.115.1)
None
integer ([MS-
ASDTYPE] section
2.5)
0…..1
(optional)
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.152) 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.
2.2.3.88.2 MaxPictures (Search)
The MaxPictures element is an optional child element of the Picture element in Search
command requests that limits the number of contact photos returned in the server response.
All elements referenced in this section are defined in the Search namespace.
Command
request/response
Parent elements
Child
elements
Data type
Number
allowed
Search command request
(section 2.2.2.14.1)
Picture (section
2.2.3.115.2)
None
integer ([MS-
ASDTYPE] section
2.5)
0…..1
(optional)
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
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011
164 / 369