2.2.3.177.13 Status (Search)
The Status element is a required child element of the Search element, the Store element, and the gal:Picture element in Search command responses.
Elements referenced in this section are defined in the Search 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 |
|---|---|---|---|---|
|
Search command response (section 2.2.1.16) |
Search (section 2.2.3.159) Store (section 2.2.3.178.3) gal:Picture (section 2.2.3.135.3) |
None |
integer ([MS-ASDTYPE] section 2.6) |
1…1 (required) |
As a child element of the Search element, the Status element indicates whether the server encountered an error while it was processing the search query. The Status element value indicates only that the overall Search command request (section 2.2.1.16) was processed correctly. It does not indicate whether any matches were found. The Total (section 2.2.3.184.3) and Range (section 2.2.3.143.3) elements in the Search command response indicate how many matches were found and returned, respectively. The following table specifies valid values for the Status element when it is returned as a child element of the Search element.
|
Value |
Meaning |
|---|---|
|
1 |
Success |
|
3 |
Server error |
As a child element of the Store element, the Status element indicates whether the server encountered an error while it was processing the Search query for the specified store. The following table specifies valid values for the Status element as a child of the Store element in the Search response.
|
Value |
Meaning |
Cause |
Scope |
Resolution |
|---|---|---|---|---|
|
1 |
Success. |
Server successfully completed command. |
Global |
None. |
|
2 |
The request was invalid. |
One or more of the client's search parameters was invalid. |
Item |
If the user formatted the request, prompt the user to retry with different options. |
|
3 |
An error occurred on the server. |
Server misconfiguration, temporary system issue, or bad item. This is frequently a transient condition. |
Global |
Retry the Search command. |
|
4 |
Bad link. |
A bad link was supplied. |
Global |
Prompt user to reformat link. |
|
5 |
Access denied. |
Access was denied to the resource |
Global |
Prompt the user. |
|
6 |
Not found. |
Resource was not found. |
Global |
Prompt the user. |
|
7 |
Connection failed. |
Failed to connect to the resource. |
Global |
Prompt the user. Sometimes these are transient, so retry. If it continues to fail, point user to administrator. |
|
8 |
Too complex. |
The query was too complex. |
Global |
Reduce the complexity of the query. Prompt user if necessary. |
|
10 |
Timed out. |
The search timed out. |
Global |
The search timed out. Retry with or without rebuilding results. If it continues, contact the Administrator. |
|
11 |
FolderSync required. |
The folder hierarchy is out of date. |
Global |
Issue a FolderSync command (section 2.2.1.5) and then try the Search command again. |
|
12 |
End of retrievable range warning. |
The requested range has gone past the end of the range of retrievable results. |
Local |
Prompt the user that there are no more results that can be fetched, and the user might consider restricting their search query. |
|
13 |
Access blocked. |
Access is blocked to the specified resource. |
Global |
Prompt the user. |
|
14 |
Credentials required. |
To complete this request, basic credentials are required. |
Global |
If over a trusted connection, supply the basic credentials from the user (prompt if necessary). Otherwise, fail as if the access denied status code was provided. |
As a child element of the gal:Picture element, the Status element indicates whether the server encountered an error while it was processing the Search query for the contact photos. The following table shows valid values for the Status element when it is returned as a child of the gal:Picture element.
|
Value |
Meaning |
|---|---|
|
1 |
The contact photo was retrieved successfully. |
|
173 |
The user does not have a contact photo. |
|
174 |
The contact photo exceeded the size limit set by the MaxSize element (section 2.2.3.105.3). |
|
175 |
The number of contact photos returned exceeded the size limit set by the MaxPictures element (section 2.2.3.104.3). |
For information about Status values common to all ActiveSync commands, see section 2.2.2.
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 Search, Store |
Element support, child of gal:Picture |
|---|---|---|
|
2.5 |
Yes |
|
|
12.0 |
Yes |
|
|
12.1 |
Yes |
|
|
14.0 |
Yes |
|
|
14.1 |
Yes |
Yes |
|
16.0 |
Yes |
Yes |
|
16.1 |
Yes |
Yes |
The gal:Picture element is supported as a parent of the Status element only when protocol version 14.1, 16.0, or 16.1 is used.