Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



How to dial a call


Dial the first call

Dial a call with CTelephony::DialNewCall(), passing it the number to dial in a CTelephony::TTelNumber. The method starts the dialling process.

CTelephony::DialNewCall() returns a CTelephony::TCallId that identifies the call. This will be either CTelephony::EISVCall1 or CTelephony::EISVCall2. You need this ID to perform operations such as putting the call on hold and hanging up. It tells CTelephony's methods which call to operate on.

To control whether you want the call's recipient to know your identity, pass CTelephony::DialNewCall() a CTelephony::TCallParamsV1. You have three options: hide your identity, show your identity, or use the phone's default setting. To read your phone's default setting, see Caller ID - Withholding your number.

CTelephony::DialNewCall() is asynchronous; use CTelephony::EDialNewCallCancel to cancel it.

This example dials the number 123456789 and allows the remote party to see the phone's number:

#include <e32base.h>
#include <Etel3rdParty.h>

_LIT(KTheNumber, "123456789");

class CClientApp : public CActive
    { 

private:
    CTelephony* iTelephony;
    CTelephony::TCallId iCallId;

public:
    CClientApp(CTelephony* aTelephony);
    void SomeFunction();

private:
    /*
       These are the pure virtual methods from CActive that  
       MUST be implemented by all active objects
       */
    void RunL();
    void DoCancel();
   };

CClientApp::CClientApp(CTelephony* aTelephony)
    : CActive(EPriorityStandard),
      iTelephony(aTelephony)
    {
    //default constructor
    }

void CClientApp::SomeFunction()
    {
    CTelephony::TTelNumber telNumber(KTheNumber);

    CTelephony::TCallParamsV1 callParams;
    callParams.iIdRestrict = CTelephony::ESendMyId;
    CTelephony::TCallParamsV1Pckg callParamsPckg(callParams);

    iTelephony->DialNewCall(iStatus, callParamsPckg, telNumber, iCallId);
    SetActive();
    }

void CClientApp::RunL()
    {
    if(iStatus==KErrNone)
       {} // The call has been dialled successfully;
          // iCallId contains the call's ID, needed when controlling the call.
    }

void CClientApp::DoCancel()
    {
    iTelephony->CancelAsync(CTelephony::EDialNewCallCancel);
    }

Remember to link to the Etel3rdParty.lib and euser.lib libraries.

You can check the voice line's status by calling CTelephony::GetLineStatus(). The call has not connected until the status is CTelephony::EStatusConnected.

[Top]


Dial a second call

This describes how to dial a second call while another is in progress.

  1. Put the first call on hold

    This is described in Hold a call.

    If the first call was not dialled or answered by you then you cannot control it, and so you cannot put it on hold. If it is not on hold already then you will have to wait until the it is put on hold (i.e. the Voice line status changes to CTelephony::EStatusHold).

  2. Dial the second call

    This is the same as dialling a call in Dial a call. CTelephony::AnswerIncomingCall() will return a different call ID to the first call.

    Remember that dialling a call is an asynchronous operation: you do not know whether you have successfully connected until the asynchronous operation has completed. If the operation fails, remember to resume the first call; see Resume a call.

As a result, the first call is on hold, and the phone user is talking to the second caller.