QServiceChecker Class Reference
[QtTelephonyModule]

Detailed Description

The QServiceChecker class allows client applications to check to see if a service is valid to use.

Some services (e.g. GSM modems) may be available, but unusable because of hardware failure. This class allows the failure to be advertised to client applications.

All telephony services that inherit from QTelephonyService will have a default QServiceChecker instance with isValid() set to true. This can be overridden in subclasses to set isValid() to false if a hardware failure is detected during start up.

See also QTelephonyService.

Member Function Documentation

QServiceChecker::QServiceChecker ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )

Construct a new service checker object for service and attach it to parent. The object will be created in client mode if mode is Client, or server mode otherwise.

If service is empty, this class will use the first available service that supports service checking. If there is more than one service that supports service checking, the caller should enumerate them with QCommServiceManager::supports() and create separate QServiceChecker objects for each.

See also QCommServiceManager::supports().

QServiceChecker::~QServiceChecker ()

Destroy this service checker object.

bool QServiceChecker::isValid ()

Returns true if the service is valid; otherwise returns false.

See also setValid().

void QServiceChecker::setValid ( bool value )   [protected]

Sets the isValid() state to value. This is used by server-side implementations.

See also isValid().