profileenginesdkcrkeys.h File Reference

API published in: S60 3rd Ed

Capability Information

Required Capabilities

WriteDeviceData

Exceptions

No capabilities needed for reading profiles.


#include <e32std.h>

Go to the source code of this file.


Variables

const TUid  KCRUidProfileEngine = {0x101F8798}
  This is a READ-ONLY API to get information about the settings of the currently active profile.
const TUint32  KProEngActiveProfile = 0x7E000001
  The id of the currently active profile, integer value.
const TUint32  KProEngActiveRingingType = 0x7E000002
  Ringing type of the active profile, integer value.
const TUint32  KProEngActiveKeypadVolume = 0x7E000004
  Keypad volume of the active profile, integer value.
const TUint32  KProEngActiveRingingVolume = 0x7E000008
  Ringing volume of the active profile, integer value.
const TUint32  KProEngActiveWarningTones = 0x7E000020
  Warning & Game Tones of the active profile, integer value.
const TUint32  KProEngActiveMessageAlert = 0x7E000040
  Message Alert Tone of the active profile, integer value.

Variable Documentation

const TUid KCRUidProfileEngine = {0x101F8798}
 

This is a READ-ONLY API to get information about the settings of the currently active profile.

How to use:

 #include <centralrepository.h>
 #include <ProfileEngineSDKCRKeys.h>

 CRepository* cr = CRepository::NewLC( KCRUidProfileEngine );
 TInt value;

 // Get the ID of the currently active profile:
 User::LeaveIfError( cr->Get( KProEngActiveProfile, value ) );
 // use value

 // Get the ringing type of the active profile:
 User::LeaveIfError( cr->Get( KProEngActiveRingingType, value ) );
 // use value

 // Get the keypad tones volume level of the active profile:
 User::LeaveIfError( cr->Get( KProEngActiveKeypadVolume, value ) );
 // use value

 // Get the ringing volume of the active profile:
 User::LeaveIfError( cr->Get( KProEngActiveRingingVolume, value ) );
 // use value

 // Get the game and warning tone setting of the active profile:
 User::LeaveIfError( cr->Get( KProEngActiveWarningTones, value ) );
 // use value

 // Get the message alert setting of the active profile:
 User::LeaveIfError( cr->Get( KProEngActiveMessageAlert, value ) );
 // use value

 CleanupStack::PopAndDestroy( cr );

The UID of the Central Repository file containing the settings. Should be given as a parameter in CRepository::NewL() call.

const TUint32 KProEngActiveKeypadVolume = 0x7E000004
 

Keypad volume of the active profile, integer value.

Possible values:

0 (keypad tones off)
1
2 (default)
3

const TUint32 KProEngActiveMessageAlert = 0x7E000040
 

Message Alert Tone of the active profile, integer value.

Possible values:

0 = Off (= the profile is silent)
1 = On (default value)

const TUint32 KProEngActiveProfile = 0x7E000001
 

The id of the currently active profile, integer value.

Possible values:

0 = General profile (default value)
1 = Silent profile
2 = Meeting profile
3 = Outdoor profile
4 = Pager profile
5 = Off-line profile
6 = Drive profile
30-49 = User-created profiles

const TUint32 KProEngActiveRingingType = 0x7E000002
 

Ringing type of the active profile, integer value.

Possible values:

0 = Ringing (default value)
1 = Ascending
2 = Ring once
3 = Beep once
4 = Silent

const TUint32 KProEngActiveRingingVolume = 0x7E000008
 

Ringing volume of the active profile, integer value.

Possible value range: 1-10

Default value : 7

const TUint32 KProEngActiveWarningTones = 0x7E000020
 

Warning & Game Tones of the active profile, integer value.

Possible values:

0 = off
1 = on (default value)


Copyright © Nokia Corporation 2001-2008
Back to top