void OnChannelPingFail(
	int error
)

void OnChannelPingFail(
	[InAttribute] int error
)

function OnChannelPingFail(error);

Parameters

error

Type: SystemInt32
Reason code for the condition encountered, as follows.

error	Ping Failure reason
600	Application server address could not be resolved via DNS.
601	Could not connect to application server address.
602	Application server TLS/SSL certificate invalid.
603	Timed out waiting for application server HTTP response.
604	Application server returned an invalid response.
605	Application server indicated that token is unknown.

Note that only error 605 means that the token has been lost and must be resent.

Ping Failure is an optional feature of the Push Channel framework.

The application server registers for ping after receiving the Push Channel token from the mobile application. If an application server registers for ping, then the server will be periodically checked ("pinged") by the BlackBerry Dynamics Network Operation Center (NOC). If the server does not respond to a ping, then the NOC notifies the application.

The purpose of this feature is to support servers that lose the Push Channel token when they are restarted. The function that is invoked should initiate resending of the Push Channel token to the application server, if the token has been lost. This is similar to the processing when the channel is initially opened, see OnChannelOpen(String). If the application server is able to accept the token, then Push Channel notification can resume.

See also

Channel Server API

Reference