Symbian^3 Application Developer Library >

MCCECall Class Reference

class MCCECall : public MCCETransferInterface
CCE call interface cce.dll
Since
S60 v3.2

Inherits from

Public Member Functions
TInt Answer ()
TTimeIntervalSeconds CallDuration ()
TInt CallIndex ()
MCCECallObserver::TCCECallControlCaps Caps ()
TInt Dial (const TDesC8 &)
void DialEmergencyCall (const TDesC &)
const TDesC & DialledParty ()
void GetMobileCallInfo ( TDes8 &)
TInt HangUp ()
TInt Hold ()
TBool IsEmergency ()
TBool IsSecured ()
const CCCPCallParameters & Parameters ()
TInt Release ()
const TDesC & RemoteParty ()
const TDesC & RemotePartyName ()
TInt ReplaceActive ()
TInt Resume ()
TBool SecureSpecified ()
TUint32 ServiceId ()
void SetObserver (const MCCECallObserver &)
void SetParameters (const CCCECallParameters &)
TDateTime StartTime ()
CCPCall::TCallState State ()
TInt Swap ()
TCCPTone Tone ()
Inherited Functions
MCCETransferInterface::AcceptTransfer(const TBool)
MCCETransferInterface::AttendedTransfer(const TDesC &)
MCCETransferInterface::TransferTarget()const
MCCETransferInterface::UnattendedTransfer(const TDesC &)
MCCETransferInterface::~MCCETransferInterface()

Member Functions Documentation

Answer()

TInt Answer ( ) [pure virtual]

Answer an incoming call

Since
S60 v3.2
Pre-condition
Call state is MCCECallObserver::EStateRinging or MCCECallObserver::EStateQueued

CallDuration()

TTimeIntervalSeconds CallDuration ( ) const [pure virtual]

Returns duration of a call. CCE will count duration from connected state to idle state.

Since
S60 v3.2

CallIndex()

TInt CallIndex ( ) const [pure virtual]
Returns the call index of the call. The call index is valid only for calls, which are in non idle states.
Since
S60 5.2

Caps()

MCCECallObserver::TCCECallControlCaps Caps ( ) const [pure virtual]

Return call control capabilities defined in MCCECallObserver::TCCECallControlCaps .

Since
S60 v3.2

Dial(const TDesC8 &)

TInt Dial ( const TDesC8 & aDialParams ) [pure virtual]
Attempts to establish a connection using the address/number given . in CCCE::OpenNewCallL .
Since
S60 v3.2
Pre-condition
Call state is MCCECallObserver::EStateIdle and call type is MO

Parameters

const TDesC8 & aDialParams

DialEmergencyCall(const TDesC &)

void DialEmergencyCall ( const TDesC & aNumber ) [pure virtual]
Places an emergency call request. When starting the request firrst terminates all but ringing and queued calls.
Since
S60 v3.2

Parameters

const TDesC & aNumber The emergency number / address

DialledParty()

const TDesC & DialledParty ( ) const [pure virtual]
Returns the original dialled party. The original number (e.g. including DTMF) dialled for an outgoing call. Can be different than returned from MCCECall::RemoteParty() .
Since
S60 3.2

GetMobileCallInfo(TDes8 &)

void GetMobileCallInfo ( TDes8 & aCallInfo ) const [pure virtual]
Get call information. NOTE: will be removed shortly. Stop using this call use relevant getters instead! TODO this needs to be rechecked if params are to be defined in CCE as a struct for example and to return that!
Since
S60 3.2

Parameters

TDes8 & aCallInfo TMobileCallInfoV3 - TODO check this

HangUp()

TInt HangUp ( ) [pure virtual]

Terminates a call.

Since
S60 v3.2
Pre-condition
Call state is not MCCECallObserver::EStateIdle

Hold()

TInt Hold ( ) [pure virtual]
Puts a call on hold. Operation results will come via MCCECallObserver .
Since
S60 v3.2
Pre-condition
Call state is MCCECallObserver::EStateConnected or MCCECallObserver::ECCPStateTransferring Transferring state is allowed only if previous state before transferring state was on-hold.

IsEmergency()

TBool IsEmergency ( ) const [pure virtual]
Returns if call is an emergency call or not.
Since
Series 60 3.2

IsSecured()

TBool IsSecured ( ) const [pure virtual]
Get call's secure status.
Since
Series 60 3.2

Parameters()

const CCCPCallParameters & Parameters ( ) const [pure virtual]
Get call parameters.
Since
S60 3.2

Release()

TInt Release ( ) [pure virtual]
Releases the call object. This must be called to free all the resources reserved for the call. After this call PE MUST not be access the call objectanymore and observer for the class must not be used in CCE. This operation MUST always succeed. Client has to be sure call is cleared from the system and all resuorces are returned to the state before calling CCCE::OpenNewCallL . It is CCE's internal issue how it handles the actual call resources etc, and no notification will result back from this operation to client. The operation means the same as deleting an object pointer in code from PE point of view.
Since
S60 v3.2
Pre-condition
None, can always be called.
Post-condition
CCE must quarantee all resources for the call will be cleaned up. Call MUST not be referenced anymore from PE and CCE must not call MCCECallObserver after this call!

RemoteParty()

const TDesC & RemoteParty ( ) const [pure virtual]
Returns the remote party number or address of the call. In case returned remote party value is KNullDesC it means the remote party is regarded as anonymous. Can be different than returned from MCCECall::DialledParty() .
Since
S60 3.2

RemotePartyName()

const TDesC & RemotePartyName ( ) const [pure virtual]
Returns the remote party name of the call.
Since
S60 5.0

ReplaceActive()

TInt ReplaceActive ( ) [pure virtual]
Replaces active call with incoming call
Since
S60 3.2

Resume()

TInt Resume ( ) [pure virtual]
Resumes the call that is on hold. Operation results will come via MCCECallObserver .
Since
S60 v3.2
Pre-condition
Call state is MCCECallObserver::EStateHold

SecureSpecified()

TBool SecureSpecified ( ) const [pure virtual]
Return if call secure status is specified or not.
Since
Series 60 5.0

ServiceId()

TUint32 ServiceId ( ) const [pure virtual]
Returns the service-id used for the call.
Since
S60 3.2

SetObserver(const MCCECallObserver &)

void SetObserver ( const MCCECallObserver & aObserver ) [pure virtual]
Set new MCCECallObserver observer to MCCECall object. Called in case of incoming call. In that case call has no observer yet when it is created. In MO case observer is set when call is created. Repleces current observer if called at any other time.
Since
S60 v3.2

Parameters

const MCCECallObserver & aObserver

SetParameters(const CCCECallParameters &)

void SetParameters ( const CCCECallParameters & aNewParams ) [pure virtual]
Set call parameters.
Since
S60 3.2

Parameters

const CCCECallParameters & aNewParams New call paramater information.

StartTime()

TDateTime StartTime ( ) const [pure virtual]

Returns start time of the call.

Since
S60 v3.2

State()

CCPCall::TCallState State ( ) const [pure virtual]

Return current call state.

Since
S60 v3.2

Swap()

TInt Swap ( ) [pure virtual]
Swaps a connected call to holded state and resumes held call. Currently called only for active call. For CS call calls Swap in CCP interface. For other calls holds the call first and then resumes the other call.
Since
S60 v3.2
Pre-condition
Call is in connected state.
Active and held call exist.

Tone()

TCCPTone Tone ( ) const [pure virtual]
Returns the inband tone associated to an error condition or a state transition of a call. See defenition for TCCPTone.
Since
S60 3.2

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.