diff -r 89d6a7a84779 -r 25a17d01db0c Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita Fri Jan 22 18:26:19 2010 +0000 @@ -0,0 +1,23 @@ + + + + + +Caller Identity Services TutorialThis tutorial describes how to implement the caller identity services in a Symbian OS 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.

\ No newline at end of file