2.2.3.177.11 Status (Ping)

The Status element is a required child element of the Ping element in Ping command responses that indicates the success or failure of the Ping command request (section 2.2.1.13). If the command failed, the Status element contains a code that indicates the type of failure. Certain status codes have additional information that is included in the response.

All elements referenced in this section are defined in the Ping namespace.

Command request/response	Parent elements	Child elements	Data type	Number allowed
Ping command response	Ping (section 2.2.3.136)	None	integer ([MS-ASDTYPE] section 2.6)	1…1 (required)

The following table lists the status codes for the Ping command (section 2.2.1.13). 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	The heartbeat interval expired before any changes occurred in the folders being monitored.		Global	Reissue the Ping command request.
2	Changes occurred in at least one of the monitored folders. The response specifies the changed folders.		Global	Issue a Sync command request (section 2.2.1.21) for each folder that was specified in the Ping command response to retrieve the server changes. Reissue the Ping command when the Sync command completes to stay up to date.
3	The Ping command request omitted required parameters.	The Ping command request did not specify all the necessary parameters. The client MUST issue a Ping request that includes both the heartbeat interval and the folder list at least once. The server saves the heartbeat interval value (section 2.2.3.88.1), so only the folder list is required on subsequent requests.	Global	Reissue the Ping command request with the entire XML body.
4	Syntax error in Ping command request.	Frequently caused by poorly formatted WBXML.	Global	Double-check the request for accuracy.
5	The specified heartbeat interval is outside the allowed range. For intervals that were too short, the response contains the shortest allowed interval. For intervals that were too long, the response contains the longest allowed interval.	The client sent a Ping command request with a heartbeat interval that was either too long or too short.	Global	Reissue the Ping command by using a heartbeat interval inside the allowed range. Setting the interval to the value returned in the Ping response will most closely accommodate the original value specified.
6	The Ping command request specified more than the allowed number of folders to monitor. The response indicates the allowed number in the MaxFolders element (section 2.2.3.102).	The client sent a Ping command request that specified more folders than the server is configured to monitor.	Global	Direct the user to select fewer folders to monitor. Resend the Ping command request with the new, shorter list.
7	Folder hierarchy sync required.	The folder hierarchy is out of date; a folder hierarchy sync is required.	Global	Issue a FolderSync command (section 2.2.1.5) to get the new hierarchy and prompt the user, if it is necessary, for new folders to monitor. Reissue the Ping command.
8	An error occurred on the server.	Server misconfiguration, temporary system issue, or bad item. This is frequently a transient condition.	Global	Retry the Ping command.

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