Collapse all Symbian^3 Product Developer Library

Call Forward Settings Tutorial

This tutorial describes how to get and set the call forward settings in a Symbian platform device.

Use CRetrieveMobilePhoneCFList to get the list in a CMobilePhoneCFList object. The list contains the details of call forward information for one or more call forwarding conditions. For example the condition can be call forwarding when there is no reply. Conditions are enumerated in RMobilePhone::TMobilePhoneCFCondition. A list is required as there can be different forwarded numbers for different service groups such as voice, fax, data and auxiliary voice. Each entry in the list is a RMobilePhone::TMobilePhoneCFInfoEntryV1 object, recording the condition, service group, status, number, and timeout values.
Set the status and registered information of the various call forwarding services using RMobilePhone::SetCallForwardingStatus(). The change is described in a RMobilePhone::TMobilePhoneCFChangeV1 object. This is possible in a CDMA mode if the feature code strings are programmed for the call forwarding service, See Call Supplementary Services Tutorials for more information.
Use RMobilePhone::NotifyCallForwardingStatusChange() to get the notification of any changes to the status of a call forwarding service.
Use RMobilePhone::NotifyCallForwardingActive() to get the notification of any call made on a line that has active call forwarding.

Call forward settings example

The following code gets the list of call forwarding numbers that are used when the call is forwarded because the number is busy. It checks the list and prints each number.

The code assumes iMobilePhone is an RMobilePhone object.

void CClientApp::CallForwardingL()
    {

    // Create and start CF number retriever for forward-when-busy numbers
    CRetrieveMobilePhoneCFList* retrieveCFList = CRetrieveMobilePhoneCFList::NewL(iMobilePhone);

    CleanupStack::PushL(retrieveCFList);
    TRequestStatus status;

    retrieveCFList->Start(status, RMobilePhone::ECallForwardingBusy);
    User::WaitForRequest(status);
    User::LeaveIfError(status.Int());

    // Get the list of numbers
    CMobilePhoneCFList* cfList = retrieveCFList->RetrieveListL();
    CleanupStack::PushL(cfList);

    // Print each number
    TInt nEntries = cfList->Enumerate();
    RMobilePhone::TMobilePhoneCFInfoEntryV1 cfEntry;

    for (TInt i=0; i<=nEntries; i++)
        {
         cfEntry = cfList->GetEntryL(i);
         console->Printf(_L("%S\n"),cfEntry.iNumber);
        }

    // Clean up
    CleanupStack::PopAndDestroy(2); // cfList, retrieveCFList    

    }

Parent topic: Multimode Phone Sub-session Tutorials