Collapse all Symbian^3 Product Developer Library

MCCPTransferProvider Class Reference

class MCCPTransferProvider

Call transfer methods. In case plug-in support call transferring these methods can be fetched from MCCPCall::TransferProviderL. MCCPTransferObserver is used for transfer specific events. MCCPCallObserver is used for general call related status, event, error etc notifications.

Since: S60 3.2

Public Member Functions
TInt	AcceptTransfer(const TBool)
void	AddObserverL(const MCCPTransferObserver &)
TInt	AttendedTransfer(MCCPCall &)
TInt	AttendedTransfer(const TDesC &)
TInt	RemoveObserver(const MCCPTransferObserver &)
const TDesC &	TransferTarget()
TInt	UnattendedTransfer(const TDesC &)

Protected Member Functions
	~MCCPTransferProvider()

Constructor & Destructor Documentation

~MCCPTransferProvider()

~MCCPTransferProvider

(

)

[protected, inline, virtual]

Protected destructor. Object cannot be deleted from plug-in client (CCE).

Since: S60 3.2

Member Functions Documentation

AcceptTransfer(const TBool)

TInt

AcceptTransfer

(

const TBool

aAccept

)

[pure virtual]

Accept incoming call transfer request from the call remote party. Actual request result indication comes via observer class

Since: Series 60 3.2

Pre-condition: Call state is MCCPCallObserver::ECCPStateConnected or MCCPCallObserver::ECCPStateHold; MCCPObserver::CallCreated is called with the newly created call

Parameters

const TBool aAccept

ETrue - accept transfer, EFalse do not accept transfer request.

AddObserverL(const MCCPTransferObserver &)

void

AddObserverL

(

const MCCPTransferObserver &

aObserver

)

[pure virtual]

Add an observer for transfer related events. Currently CCE will set only one observer.

Since: S60 v3.2

leave: system error if observer adding fails

Parameters

const MCCPTransferObserver & aObserver

Observer to add.

AttendedTransfer(MCCPCall &)

TInt

AttendedTransfer

(

MCCPCall &

aTransferTargetCall

)

[pure virtual]

Attended transfer to given call recipient. There needs to exist two calls. a call between A-B and A-C. A wants to transfer the call to B-C. Both calls A-B and A-C will be disconnected after transfer. In above case C will be the aTransferTargetCall call recipient. B is the recipient of the current call between A-B - called on A's call object transfer provider. The A-B call is on hold. Actual request result indication comes via observer classes

Pre-condition: Call state is MCCPCallObserver::ECCPStateConnected or MCCPCallObserver::ECCPStateHold

Since: S60 3.2

Parameters

MCCPCall & aTransferTargetCall

Call containing the transfer target info.

AttendedTransfer(const TDesC &)

TInt

AttendedTransfer

(

const TDesC &

aTransferTarget

)

[pure virtual]

TODO is this used at all? remove? only the call param one is used? Attended transfer to given address. There does not need to be a current call between the given transfer target. Actual request result indication comes via observer class

Pre-condition: Call state is MCCPCallObserver::ECCPStateConnected or MCCPCallObserver::ECCPStateHold

Since: S60 3.2

Parameters

const TDesC & aTransferTarget

Transfer target address

RemoveObserver(const MCCPTransferObserver &)

TInt

RemoveObserver

(

const MCCPTransferObserver &

aObserver

)

[pure virtual]

Remove an observer.

Since: S60 v3.2

Parameters

const MCCPTransferObserver & aObserver

Observer to remove.

TransferTarget()

const TDesC &

TransferTarget

(

)

const [pure virtual]

When the other end of the call has requested call transfer to third party it is notified to MCCPTransferObserver::TransferEventOccurred(MCCPTransferObserver::ECCPRemoteTransferring). The new recipient of the call can be fetched via this method.

Since: Series 60 3.2

Pre-condition: Call state is MCCPCallObserver::ECCPStateConnected or MCCPCallObserver::ECCPStateHold; MCCPObserver::CallCreated is called with the newly created call

UnattendedTransfer(const TDesC &)

TInt

UnattendedTransfer

(

const TDesC &

aTransferTarget

)

[pure virtual]

Unattended transfer. Call is requested to be transferred to given address. After MCCPTransferObserver::ECCPRemoteTransferring event current call will be disconnected and no transfer status is checked from the operation. Actual request result indication comes via observer classes

Since: S60 3.2

Pre-condition: Call state is MCCPCallObserver::ECCPStateConnected or MCCPCallObserver::ECCPStateHold

Parameters

const TDesC & aTransferTarget

Address of the target