Collapse all Symbian^3 Product Developer Library

Caller Identity Services Tutorial

This tutorial describes how to implement the caller identity services in a Symbian platform device.

GSM defines the following supplementary services that display the identity of the calling or the connected party:

Calling Line Identity Presentation (CLIP)
Calling Line Identity Restriction (CLIR)
Connected Line Identity Presentation (COLP)
Connected Line Identity Restriction (COLR)
Calling Name Presentation (CNAP)

To get the status of an identity service, use RMobilePhone::GetIdentityServiceStatus()
Possible services are described in the RMobilePhone::TMobilePhoneIdService enum and the status values in RMobilePhone::TMobilePhoneIdServiceStatus.

Caller identity example

The following code checks if the CNAP service is active that is if the name of the caller is shown.

The code assumes iMobilePhone is an RMobilePhone object.

TRequestStatus status;
RMobilePhone::TMobilePhoneIdServiceStatus serviceStatus;

iMobilePhone.GetIdentityServiceStatus(status,RMobilePhone::EIdServiceCallerName, serviceStatus);
User::WaitForRequest(status);
User::LeaveIfError(status.Int());

if (serviceStatus == RMobilePhone::EIdServiceActivePermanent)
    {
        //do something
    }

There are no setter functions for the above described supplementary services. Contact the service provider to change the service activation.

Parent topic: Multimode Phone Sub-session Tutorials