Collapse all Symbian^3 Product Developer Library

Call Waiting Settings Tutorial

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

Use CRetrieveMobilePhoneCWList to get a list of call waiting entries in a CMobilePhoneCWList object. A list that indicates different waiting status for different service groups such as voice, fax, data and auxiliary voice is required. Each entry in the list is a RMobilePhone::TMobilePhoneCWInfoEntryV1 object, recording the service group and call waiting status.
Set the status of the call waiting service using RMobilePhone::SetCallWaitingStatus(). The action taken is described in RMobilePhone::TMobilePhoneServiceAction. This is possible only in the CDMA mode if the feature code strings are programmed for the call forwarding service, see Call Supplementary Services Tutorial for more information
Use RMobilePhone::NotifyCallWaitingStatusChange() to get the notification of any changes in the status of the call waiting service.

Call waiting settings example

The following code gets the list of call waiting entries, and prints each service group for which call waiting is active. The code assumes iMobilePhone is an RMobilePhone object.

void CClientApp::CallWaitingL()
    {

    // Create and start CW retriever
    CRetrieveMobilePhoneCWList* retrieveCWList = CRetrieveMobilePhoneCWList::NewL(iMobilePhone);
    CleanupStack::PushL(retrieveCWList);

    TRequestStatus status;
    retrieveCWList->Start(status);
    User::WaitForRequest(status);
    User::LeaveIfError(status.Int());

    // Get the list of call waiting entries
    CMobilePhoneCWList* cwList = retrieveCWList->RetrieveListL();
    CleanupStack::PushL(cwList);

    // Print each service group for which CW is active
    TInt nEntries = cwList->Enumerate();
    RMobilePhone::TMobilePhoneCWInfoEntryV1 cwEntry;

    // Names of service groups 
    TText* aServiceGroupNameStings[]={_S("Unspecified"), _S("Voice"), _S("Auxiliary Voice"),
        _S("CSD"),_S("Packet"),_S("Fax"),_S("SMS"),_S("All")};
    TPtr aServiceGroupName(NULL,20);

    for (TInt i=0; i<=nEntries; i++)
        {
         cwEntry = cwList->GetEntryL(i);
         if (cwEntry.iStatus == RMobilePhone::ECallWaitingStatusActive)
            {
             aServiceGroupName = aServiceGroupNameStings[cwEntry.iServiceGroup];
             console->Printf(_L("Call waiting active for service group %d\n"),aServiceGroupName); 
            }
        }

    // Clean up
    CleanupStack::PopAndDestroy(2); // cwList, retrieveCWList    

    }

Parent topic: Multimode Phone Sub-session Tutorials