Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Archived:How to mute a ringing tone on S60 3rd Edition devices

From Wiki
Jump to: navigation, search

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

Article Metadata
Platform(s): S60 3rd Edition,
S60 3rd Edition, FP1
S60 3rd Edition FP1
S60 3rd Edition (initial release)
Created: User:Technical writer 2 (21 May 2007)
Last edited: lpvalente (23 Nov 2012)



This article describes how to mute a ringing tone on S60 3rd Edition devices.


When a call arrives, its ringing tone can be muted with Phone Client Extension API, part of the API extension plug-in package for S60 3rd Edition.

The 3rd party Telephony API (CTelephony) can be used for observing incoming call events.

Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, MR Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, supporting FP1


The below code shows how to load the PhoneClientExt DLL and how to construct and use a command handler (CPhCltCommandHandler) to mute a ringing tone.

Required capability: WriteDeviceData

    /*** Header file ***/
#include <RPhCltServer.h> // link against PhoneClient.lib
#include <PhCltExt.h> // link against PhoneClientExt.lib
RPhCltServer iPhoneClientServer;
RLibrary iLibrary;
CPhCltCommandHandler* iPhCommandHandler;
/*** Source file ***/
_LIT(KPhoneCltExDllName, "PhoneClientExt.dll");
User::LeaveIfError( iPhoneClientServer.Connect() );
User::LeaveIfError( iLibrary.Load(KPhoneCltExDllName) );
TInt res = iLibrary.Lookup(1)();
CPhCltExtFactory* phCltExtFactory = reinterpret_cast<CPhCltExtFactory*>( res );
iPhCommandHandler = phCltExtFactory->CPhCltCommandHandlerLD();
User::LeaveIfError( iPhCommandHandler->Open(iPhoneClientServer) );
// Mute an ongoing ringing tone. This should be done inside an active object
// (a class derived from CActive)
iPhCommandHandler->MuteRingingTone( iStatus );

See also

How to mute/unmute the microphone on S60 3rd Edition devices

This page was last modified on 23 November 2012, at 20:08.
49 page views in the last 30 days.