diff -r 4816d766a08a -r f345bda72bc4 Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita --- a/Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita Tue Mar 30 11:42:04 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita Tue Mar 30 11:56:28 2010 +0100 @@ -1,23 +1,54 @@ - - - - - -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 + + + + + +Caller +Identity Services TutorialThis 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.

+ \ No newline at end of file