2.2.3.177.7 Status (GetItemEstimate)
The Status element is a required child element of the Response element and an optional child element of the GetItemEstimate element in GetItemEstimate command responses that indicates the success or failure of part or all of a GetItemEstimate command request (section 2.2.1.9).
Elements referenced in this section are defined in the GetItemEstimate 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 |
|---|---|---|---|---|
|
GetItemEstimate command response |
GetItemEstimate (section 2.2.3.85) |
None |
integer ([MS-ASDTYPE] section 2.6) |
0…1 (optional) |
|
GetItemEstimate command response |
Response (section 2.2.3.153.3) |
None |
integer |
1…1 (required) |
If the entire request command fails, the Status element is present as a child of the GetItemEstimate element and contains a value that indicates the type of global failure. However, if the failure occurs at the Collection (section 2.2.3.29.1) level, a Status value is returned per Collection as a child of the Response element.
The following table lists the status codes for the GetItemEstimate command (section 2.2.1.9). 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 |
Scope |
Resolution |
|---|---|---|---|---|
|
1 |
Success. |
Server successfully completed command. |
Global |
None. |
|
2 |
A collection was invalid or one of the specified collection IDs was invalid. |
One or more of the specified folders does not exist or an incorrect folder was requested. |
Item |
Issue a FolderSync command (section 2.2.1.5) to get the new hierarchy. Then retry with a valid collection or collection ID. |
|
3 |
The synchronization state has not been primed. |
The client has issued a GetItemEstimate command without first issuing a Sync command request (section 2.2.1.21) with an airsync:SyncKey element (section 2.2.3.181.4) value of zero (0). |
Item |
Issue a Sync command with synchronization key of zero (0) before issuing the GetItemEstimate command again. |
|
4 |
The specified synchronization key was invalid. |
Malformed or mismatched synchronization key. —or— The synchronization state is corrupted on the server. |
Global |
Issue a successful Sync command prior to issuing the GetItemEstimate command again. If the error is repeated, issue a Sync command with an airsync:SyncKey element value of zero (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 |
Yes |
|
12.0 |
Yes |
|
12.1 |
Yes |
|
14.0 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |