2.2.3.177.2 Status (Find)
The Status element is a required child element of the Find element and the Response element in Find command responses.
Elements referenced in this section are defined in the Find namespace.
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
Find command response (section 2.2.1.2) |
Find (section 2.2.3.69) Response (section 2.2.3.153.2) |
None |
integer ([MS-ASDTYPE] section 2.6) |
1…1 (required) |
As a child element of the Find element, the Status element indicates whether the server encountered an error while it was processing the Find query. The Status element value indicates only that the overall Find command request (section 2.2.1.2) was processed correctly. It does not indicate whether any matches were found. The Total (section 2.2.3.184.1) and Range (section 2.2.3.143.1) elements in the Find command response indicate how many matches were found and returned, respectively.
As a child element of the Response element, the Status element indicates whether the server encountered an error while it was processing the Find query. The following table lists the status codes for the Find command. For information about the scope of the status value and for status values common to all ActiveSync commands, see section 2.2.2.
|
Value |
Meaning |
Cause |
Parent Elements |
Resolution |
|---|---|---|---|---|
|
1 |
Success. |
Server successfully completed command. |
Find element Response element |
None. |
|
2 |
The request was invalid. |
The client's search failed to validate. |
Find element Response element |
Double-check the request for accuracy. |
|
3 |
FolderSync required. |
The folder hierarchy is out of date. |
Find element |
Issue a FolderSync command (section 2.2.1.5) and then try the Find command again. |
|
4 |
StartWithRangeZero |
The requested range does not begin with 0. |
Response element |
Issue a new Find request with a Range value that begins with 0. |
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 |
|
|
16.0 |
|
|
16.1 |
Yes |