Dela via


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