Symbian^3 Application Developer Library >

MCCPForwardProvider Class Reference

class MCCPForwardProvider

Call forward methods. In case plug-in support call forwarding these methods can be fetched from MCCPCall::ForwardProviderL . MCCPForwardObserver is used for forwarding specific events. MCCPCallObserver is used for general call related status, event, error etc notifications.

Since
S60 3.2
Public Member Functions
void AddObserverL (const MCCPForwardObserver &)
void ForwardToAddressL (const TInt )
const CDesC8Array & GetForwardAddressChoicesL ()
TInt RemoveObserver (const MCCPForwardObserver &)
Protected Member Functions
~MCCPForwardProvider ()

Constructor & Destructor Documentation

~MCCPForwardProvider()

~MCCPForwardProvider ( ) [protected, inline, virtual]
Protected destructor. Object cannot be deleted from plug-in client (CCE).
Since
S60 3.2

Member Functions Documentation

AddObserverL(const MCCPForwardObserver &)

void AddObserverL ( const MCCPForwardObserver & aObserver ) [pure virtual]
Add an observer for forward related events. Currently CCE will set only one observer.
Since
S60 v3.2
leave
system error if observer adding fails

Parameters

const MCCPForwardObserver & aObserver Observer to add.

ForwardToAddressL(const TInt)

void ForwardToAddressL ( const TInt aIndex ) [pure virtual]
Forward call to address at given index.
Since
Series 60 3.2
leave
KErrArgument Index is not in array
leave
KErrNotReady Call is not in forwarding state
leave
KErrNotSupported If call is not mobile originated
Pre-condition
Call state is MCCPCallObserver::ECCPStateForwarding and call type is MO
Call MCCPForwardObserver::ECCPMultipleChoices event is received

Parameters

const TInt aIndex Index of address where the call is to be forwarded. Address is found in the array received from GetForwardAddressChoicesL. Index starts from zero.

GetForwardAddressChoicesL()

const CDesC8Array & GetForwardAddressChoicesL ( ) [pure virtual]
Returns pointer to array containing addresses to forward the call to. Index zero contains the first address. If there are no addresses available returns an empty array.
Since
Series 60 3.2
leave
KErrNotReady call is not in forwarding state
leave
KErrNotSupported if call is not mobile originated
leave
system error code
Pre-condition
Call state is MCCPCallObserver::ECCPStateForwarding and call type is MO
Call MCCPForwardObserver::ECCPMultipleChoices event is received

RemoveObserver(const MCCPForwardObserver &)

TInt RemoveObserver ( const MCCPForwardObserver & aObserver ) [pure virtual]
Remove an observer.
Since
S60 v3.2

Parameters

const MCCPForwardObserver & aObserver Observer to remove.

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.