Collapse all Symbian^3 Application Developer Library

RCommsMobilityApiExt Class Reference

class RCommsMobilityApiExt : public RCommsApiExtension< EMobilityApiExt >

Comms Mobility API extension for client not running an Active Scheduler.

This class can actually be used by any client, one running an Active Scheduler and one that is not. However, if the Active Scheduler is present, it is recommended to use CActiveCommsMobilityApiExt which is much simpler.

CActiveCommsMobilityApiExt

Inherits from

RCommsMobilityApiExt
- RCommsApiExtension< EMobilityApiExt >
  - RCommsApiExtensionBase

Public Member Functions
	RCommsMobilityApiExt ()
IMPORT_C void	CancelMobilityNotification ()
IMPORT_C void	Close ()
IMPORT_C void	IgnorePreferredCarrier ()
IMPORT_C void	MigrateToPreferredCarrier ()
IMPORT_C void	NewCarrierAccepted ()
IMPORT_C void	NewCarrierRejected ()
IMPORT_C void	RegisterForMobilityNotification ( TDes8 &, TRequestStatus &)

Inherited Functions
	RCommsApiExtension< EMobilityApiExt >::Open(RCommsSession &)
	RCommsApiExtension< EMobilityApiExt >::Open(RCommsSubSession &)
	RCommsApiExtensionBase::Open(RCommsSession &,TSupportedCommsApiExt)
	RCommsApiExtensionBase::Open(RCommsSubSession &,TSupportedCommsApiExt)
	RCommsApiExtensionBase::RCommsApiExtensionBase()
	RCommsApiExtensionBase::SendMessage(TCommsApiExtReqMsg &)
	RCommsApiExtensionBase::SendRequest(TCommsApiExtReqMsg &,TDes8 &,TRequestStatus &)

Inherited Attributes
	RCommsApiExtensionBase::iInterfaceId
	RCommsApiExtensionBase::iProvider

Constructor & Destructor Documentation

RCommsMobilityApiExt()

IMPORT_C

RCommsMobilityApiExt

(

)

[explicit]

Default empty constructor, and is present only to support virtual function table export.

Member Functions Documentation

CancelMobilityNotification()

IMPORT_C void

CancelMobilityNotification

(

)

Cancels previously requested subscription for Mobility notifications.

Close()

IMPORT_C void

(

)

Closes the extension after it has been used. It is not possible to use an extension after it has been closed.

IgnorePreferredCarrier()

IMPORT_C void

IgnorePreferredCarrier

(

)

Instructs the Implementation that it should not migrate the Client to the newly available preferred carrier and that the Client wishes to continue using the current carrier.

MigrateToPreferredCarrier()

IMPORT_C void

MigrateToPreferredCarrier

(

)

Instructs the Implementation that it should migrate the Client to the newly available preferred carrier (or, in case of the current carrier becoming unavailable, to the less preferred but available carrier).

NewCarrierAccepted()

IMPORT_C void

NewCarrierAccepted

(

)

Instructs the Implementation that the Client wishes to use the new carrier it has been migrated to.

NewCarrierRejected()

IMPORT_C void

NewCarrierRejected

(

)

Instructs the Implementation that the Client wishes to reject the new carrier it has been migrated to and be offered another preferred carrier unless nothing else is available. In case nothing else is available the request completes with an error.

RegisterForMobilityNotification(TDes8 &, TRequestStatus &)

IMPORT_C void	RegisterForMobilityNotification	(	TDes8 &	aResponseEventBuf,
			TRequestStatus &	aStatus
		)

This API is used to register (subscribe) for Mobility notifications from the Implementation.

Parameters

TDes8 & aResponseEventBuf	Will be filled with a corresponding response message before aStatus is completed.
TRequestStatus & aStatus