net.rim.device.api.system
Interface CoverageStatusListener

public interface CoverageStatusListener

The listener interface for receiving notifications of changes in coverage status, taking into account radio coverage, serial bypass and Bluetooth coverage, and any required service book records.

The following two conditions must be true before a device is considered to be in sufficient coverage for a connection type:

1. The device has sufficient radio/serial bypass/Bluetooth coverage for that connection type.
2. All service book records required for that connection type are routable.

Since:

JDE 4.2.0

See Also:

CoverageInfo

Method Summary

void	coverageStatusChanged(int newCoverage) Indicates that the coverage status has changed.

Method Detail

coverageStatusChanged

public void coverageStatusChanged(int newCoverage)

Indicates that the coverage status has changed.

Note that a CoverageInfo.COVERAGE_* flag being set in newCoverage is not a guarantee that a connection of that type will succeed. For example, it is possible for the device to lose coverage between the time this notification was fired and a subsequent connection is attempted, or for a destination server to be unresponsive.

Parameters:

newCoverage - The new coverage status, consisting of a bitwise OR of one or more CoverageInfo.COVERAGE_* flags.

Since:

JDE 4.2.0