RASCliSession Class Reference

#include <mw/asclisession.h>

Link against: alarmclient.lib

class RASCliSession : public RSessionBase

Inherits from

RASCliSession

Public Member Functions
	RASCliSession()
IMPORT_C TInt	AlarmAdd(TASShdAlarm &)
IMPORT_C TInt	AlarmAdd(TASShdAlarm &, const TDesC8 &)
IMPORT_C void	AlarmAddWithNotification(TRequestStatus &, TASShdAlarm &)
IMPORT_C void	AlarmAddWithNotification(TRequestStatus &, TASShdAlarm &, const TDesC8 &)
IMPORT_C TInt	AlarmCountByState(TAlarmState)
IMPORT_C TInt	AlarmDataAttachL(TAlarmId, const TDesC8 &)
IMPORT_C TInt	AlarmDataDetach(TAlarmId)
TInt	AlarmDataDetatch(TAlarmId)
IMPORT_C TInt	AlarmDataSize(TAlarmId)
IMPORT_C TInt	AlarmDelete(TAlarmId)
IMPORT_C TInt	AlarmDeleteAllByCategory(TAlarmCategory, TBool)
IMPORT_C TInt	AlarmDeleteByCalendarFile(const TDesC &, TDeleteType)
IMPORT_C TInt	AlarmDeleteByCategory(TAlarmCategory, TDeleteType)
IMPORT_C void	AlarmNotificationCancelAndDequeue(TAlarmId)
IMPORT_C TBool	AlarmSoundsTemporarilySilenced()
IMPORT_C TInt	CancelAlarmSilence()
IMPORT_C TInt	Connect()
IMPORT_C TInt	GetAlarmCategory(TAlarmId, TAlarmCategory &)
IMPORT_C TInt	GetAlarmCharacteristics(TAlarmId, TAlarmCharacteristicsFlags &)
IMPORT_C TInt	GetAlarmCountForCategory(TAlarmCategory)
IMPORT_C TInt	GetAlarmData(TAlarmId, TDes8 &)
IMPORT_C TInt	GetAlarmData(TAlarmId, HBufC8 *&)
IMPORT_C TInt	GetAlarmDayOrTimed(TAlarmId, TAlarmDayOrTimed &)
IMPORT_C TInt	GetAlarmDetails(TAlarmId, TASShdAlarm &)
IMPORT_C void	GetAlarmIdListByStateL(TAlarmState, RArray< TAlarmId > &)
IMPORT_C void	GetAlarmIdListForCategoryL(TAlarmCategory, RArray< TAlarmId > &)
IMPORT_C void	GetAlarmIdListL(RArray< TAlarmId > &)
IMPORT_C TInt	GetAlarmOwner(TAlarmId, TFullName &)
IMPORT_C void	GetAlarmPlayIntervalsL(CArrayFix< TASCliSoundPlayDefinition > &)
IMPORT_C TInt	GetAlarmSoundState(TAlarmGlobalSoundState &)
IMPORT_C TInt	GetAlarmSoundsSilentUntil(TTime &)
IMPORT_C TInt	GetAlarmStatus(TAlarmId, TAlarmStatus &)
IMPORT_C void	GetAvailableCategoryListL(RArray< TAlarmCategory > &)
IMPORT_C TInt	GetNextDueAlarmId(TAlarmId &)
IMPORT_C void	NotifyChange(TRequestStatus &, TAlarmId &)
IMPORT_C void	NotifyChangeCancel()
IMPORT_C TInt	NumberOfAlarmsActiveInQueue()
IMPORT_C TInt	SetAlarmCharacteristics(TAlarmId, TAlarmCharacteristicsFlags)
IMPORT_C TInt	SetAlarmDayOrTimed(TAlarmId, TAlarmDayOrTimed)
IMPORT_C void	SetAlarmPlayIntervalsL(const CArrayFix< TASCliSoundPlayDefinition > &)
IMPORT_C TInt	SetAlarmSoundState(TAlarmGlobalSoundState)
IMPORT_C TInt	SetAlarmSoundsSilentFor(TTimeIntervalMinutes)
IMPORT_C TInt	SetAlarmSoundsSilentUntil(const TTime &)
IMPORT_C TInt	SetAlarmStatus(TAlarmId, TAlarmStatus)
IMPORT_C TInt	SetAlarmStatusByCategory(TAlarmCategory, TAlarmStatus)
IMPORT_C TInt	SetAlarmStatusForCalendarFile(const TDesC &, TAlarmStatus)
IMPORT_C TInt	SetClientData(const TASShdAlarm &)
IMPORT_C TVersion	Version()
IMPORT_C void	__DbgFailAlloc(TInt)
IMPORT_C void	__DbgPreventUserNotify(TBool)
IMPORT_C TInt	__DbgSetEnvChgHandling(TBool)
IMPORT_C void	__DbgShutDownServer()
IMPORT_C TInt	__DbgSnoozeAlarm(TAlarmId, const TTime &)

Inherited Attributes
	RHandleBase::iHandle

Inherited Enumerations
	RHandleBase:TAttributes
	RSessionBase:TAttachMode

Inherited Functions
	RHandleBase::Attributes()const
	RHandleBase::BTraceId()const
	RHandleBase::Close()
	RHandleBase::DoExtendedClose()
	RHandleBase::Duplicate(const RThread &,TOwnerType)
	RHandleBase::FullName()const
	RHandleBase::FullName(TDes &)const
	RHandleBase::Handle()const
	RHandleBase::HandleInfo(THandleInfo *)
	RHandleBase::Name()const
	RHandleBase::NotifyDestruction(TRequestStatus &)
	RHandleBase::Open(const TFindHandleBase &,TOwnerType)
	RHandleBase::OpenByName(const TDesC &,TOwnerType,TInt)
	RHandleBase::RHandleBase()
	RHandleBase::RHandleBase(TInt)
	RHandleBase::SetHandle(TInt)
	RHandleBase::SetHandleNC(TInt)
	RSessionBase::CreateSession(RServer2,const TVersion &)
	RSessionBase::CreateSession(RServer2,const TVersion &,TInt)
	RSessionBase::CreateSession(RServer2,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy ,TRequestStatus )
	RSessionBase::CreateSession(const TDesC &,const TVersion &)
	RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt)
	RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy ,TRequestStatus )
	RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TRequestStatus *)
	RSessionBase::Open(RMessagePtr2,TInt,TOwnerType)
	RSessionBase::Open(RMessagePtr2,TInt,const TSecurityPolicy &,TOwnerType)
	RSessionBase::Open(TInt,TOwnerType)
	RSessionBase::Open(TInt,const TSecurityPolicy &,TOwnerType)
	RSessionBase::Send(TInt)const
	RSessionBase::Send(TInt,const TIpcArgs &)const
	RSessionBase::SendReceive(TInt)const
	RSessionBase::SendReceive(TInt,TRequestStatus &)const
	RSessionBase::SendReceive(TInt,const TIpcArgs &)const
	RSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const
	RSessionBase::SetReturnedHandle(TInt)
	RSessionBase::SetReturnedHandle(TInt,RHandleBase &)
	RSessionBase::SetReturnedHandle(TInt,const TSecurityPolicy &)
	RSessionBase::ShareAuto()
	RSessionBase::ShareProtected()

Detailed Description

The client-side interface to the Symbian OS alarm server.

Constructor & Destructor Documentation

RASCliSession ( )

IMPORT_C

RASCliSession

(

)

Default constructor.

Creates an instance of the RASCliSession class, setting its pointers to null.

Member Function Documentation

AlarmAdd ( TASShdAlarm & )

IMPORT_C TInt

AlarmAdd

(

TASShdAlarm &

aAlarm

)

const

Validates an alarm object, allocates an unique identifier to it, and adds the object synchronously to the alarm server's queue.

capability: WriteUserData

Parameter	Description
aAlarm	The alarm object to add. On return, contains a unique identifier that the client can use to identify the alarm.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

AlarmAdd ( TASShdAlarm &, const TDesC8 & )

IMPORT_C TInt	AlarmAdd	(	TASShdAlarm &	aAlarm,
			const TDesC8 &	aData
		)	const

Validates an alarm object, allocates an unique identifier to it, and adds the object with data synchronously to the alarm server's queue.

capability: WriteUserData

Parameter	Description
aAlarm	The alarm object to add. On return, contains a unique identifier that the client can use to identify the alarm.
aData	Client-specific data to associate with the alarm.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

AlarmAddWithNotification ( TRequestStatus &, TASShdAlarm & )

IMPORT_C void	AlarmAddWithNotification	(	TRequestStatus &	aStatus,
			TASShdAlarm &	aAlarm
		)

Makes an asynchronous request to add an alarm object to the alarm server's queue.

It also allocates a unique identifier of type TAlarmId to the alarm object and adds the alarm object to the alarm server's queue.

When the alarm expires, or is cancelled, the alarm server notifies the client by completing the outstanding request.

capability: WriteUserData

Parameter	Description
aStatus	On completion of the request, this object holds the completion code.
aAlarm	The alarm to add. On return, contains the unique identifier. KNullAlarmId indicates failure.

AlarmAddWithNotification ( TRequestStatus &, TASShdAlarm &, const TDesC8 & )

IMPORT_C void	AlarmAddWithNotification	(	TRequestStatus &	aStatus,
			TASShdAlarm &	aAlarm,
			const TDesC8 &	aData
		)

Makes an asynchronous request to add an alarm object with the agenda entry information attached to the alarm server's queue.

It also allocates a unique identifier of type TAlarmId to the alarm object and adds the alarm object to the alarm server's queue.

When the alarm expires, or is cancelled, the alarm server notifies the client by completing the outstanding request.

capability: WriteUserData

Parameter	Description
aStatus	On completion of the request, this object holds the completion code.
aAlarm	The alarm to add. On return, contains the unique identifier. KNullAlarmId indicates failure.
aData	Client-specific data to associate with the alarm.

AlarmCountByState ( TAlarmState )

IMPORT_C TInt

AlarmCountByState

(

TAlarmState

aState

)

const

Returns the number of alarms in a specified state.

capability: None

Parameter	Description
aState	Alarm state of interest.

Returns: Number of alarms in the specified state.

AlarmDataAttachL ( TAlarmId, const TDesC8 & )

IMPORT_C TInt	AlarmDataAttachL	(	TAlarmId	aAlarmId,
			const TDesC8 &	aData
		)	const

Associates the specified data with an alarm.

This is arbitrary client-specific data, for which the alarm server simply acts as a router.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	Unique identifier of the alarm.
aData	Client-specific data to associate with the alarm.

Returns: KErrNone if successful, KErrInUse if the specified alarm already has data assigned to it, or one of the system-wide error codes.

AlarmDataDetach ( TAlarmId )

IMPORT_C TInt

AlarmDataDetach

(

TAlarmId

aAlarmId

)

const

Removes any previously attached alarm data from the specified alarm.

This releases any resources allocated by the alarm server for this alarm.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	Unique identifier for the alarm.

Returns: KErrNone if successful, KErrNotFound if the specified alarm does not exist (or the specified alarm does not have any data), or another of the system-wide error codes.

AlarmDataDetatch ( TAlarmId )

TInt

AlarmDataDetatch

(

TAlarmId

aAlarmId

)

const [inline]

Deprecated8.0

RASCliSession::AlarmDataDetach() should be used instead

AlarmDataSize ( TAlarmId )

IMPORT_C TInt

AlarmDataSize

(

TAlarmId

aAlarmId

)

const

Returns the size in bytes of any data associated with the specified alarm.

capability: None

Parameter	Description
aAlarmId	Unique identifier of the alarm under query.

Returns: The size in bytes of the alarm's data, or an error. KErrNotFound is returned if the specified alarm does not have any associated data.

AlarmDelete ( TAlarmId )

IMPORT_C TInt

AlarmDelete

(

TAlarmId

aAlarmId

)

const

Deletes an alarm from the alarm server.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	The unique identifier of the alarm to be deleted.

Returns: KErrNone if successful, KErrNotFound if the specified alarm does not exist, KErrAccessDenied if the alarm has an outstanding notification, or else one of the system-wide error codes.

AlarmDeleteAllByCategory ( TAlarmCategory, TBool )

IMPORT_C TInt	AlarmDeleteAllByCategory	(	TAlarmCategory	aCategory,
			TBool	aDeleteOnlyOrphanedAlarmsInCategory
		)	const

Deletes all alarms in the queue corresponding to a specified category.

You can also specify that only the orphaned alarms of that category be deleted.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aCategory	Category of alarms to be deleted.
aDeleteOnlyOrphanedAlarmsInCategory	ETrue: delete only orphaned alarms within the category. EFalse: delete all alarms within the category.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

AlarmDeleteByCalendarFile ( const TDesC &, TDeleteType )

IMPORT_C TInt	AlarmDeleteByCalendarFile	(	const TDesC &	aFileName,
			TDeleteType	aWhatToDelete
		)	const

Delete alarms based on their type and the Calendar filename to which alarms belong

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aFileName	specify the name of the Calendar file which alarms came from
aWhatToDelete	specify what type of alarms to delte within the category.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

AlarmDeleteByCategory ( TAlarmCategory, TDeleteType )

IMPORT_C TInt	AlarmDeleteByCategory	(	TAlarmCategory	aCategory,
			TDeleteType	aWhatToDelete
		)	const

Deletes alarms in the queue corresponding to a specified category and type.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aCategory	Category of alarms to be deleted.
aWhatToDelete	specify what type of alarms to delte within the category.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

AlarmNotificationCancelAndDequeue ( TAlarmId )

IMPORT_C void

AlarmNotificationCancelAndDequeue

(

TAlarmId

aAlarmId

)

const

Cancels an outstanding notification for an alarm and removes it from the queue.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	The unique identifier of the alarm to be cancelled.

AlarmSoundsTemporarilySilenced ( )

IMPORT_C TBool

AlarmSoundsTemporarilySilenced

(

)

const

Tests whether the alarm server has temporarily disabled sounds.

capability: None

Returns: ETrue: alarms are temporarily silent. EFalse: sounds are not silent.

CancelAlarmSilence ( )

IMPORT_C TInt

CancelAlarmSilence

(

)

const

Cancels the silent period, turning the alarm sounds on.

capability: WriteDeviceData

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

Connect ( )

IMPORT_C TInt

Connect

(

)

Connects the client process to the alarm server, starting the server if it is not already running.

capability: None

Returns: KErrNone if successful, otherwise one of the system-wide errors.

GetAlarmCategory ( TAlarmId, TAlarmCategory & )

IMPORT_C TInt	GetAlarmCategory	(	TAlarmId	aAlarmId,
			TAlarmCategory &	aCategory
		)	const

Retrieves the category of an alarm.

capability: None

Parameter	Description
aAlarmId	The unique identifier of the alarm under query.
aCategory	On return, contains the category of the alarm.

Returns: KErrNone if successful, KErrNotFound if the alarm does not exist, otherwise one of the system-wide error codes.

GetAlarmCharacteristics ( TAlarmId, TAlarmCharacteristicsFlags & )

IMPORT_C TInt	GetAlarmCharacteristics	(	TAlarmId	aAlarmId,
			TAlarmCharacteristicsFlags &	aCharacteristics
		)	const

Gets the characteristics of an alarm.

capability: None

Parameter	Description
aAlarmId	Unique identifier of the alarm under query.
aCharacteristics	On return, contains the charcteristics of the alarm specified.

Returns: KErrNone if successful, otherwise one of the system-wide errors.

GetAlarmCountForCategory ( TAlarmCategory )

IMPORT_C TInt

GetAlarmCountForCategory

(

TAlarmCategory

aCategory

)

const

Returns the number of alarms in a specified category.

capability: None

Parameter	Description
aCategory	Category of alarm under query.

Returns: Number of alarms in the specified category, or, if negative, one of the standard error codes..

GetAlarmData ( TAlarmId, TDes8 & )

IMPORT_C TInt	GetAlarmData	(	TAlarmId	aAlarmId,
			TDes8 &	aSink
		)	const

Retrieves the data attached to the specified alarm.

This is data previously attached using AlarmDataAttachL().

capability: Note If the user does not have ReadUserData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	Unique identifier of the alarm under query.
aSink	On return, contains the data associated with the alarm. This buffer must be large enough to contain all the data or a panic occurs.

Returns: KErrNone if successful, KErrNotFound if the specified alarm does not have any associated data, or a system-wide error.

GetAlarmData ( TAlarmId, HBufC8 *& )

IMPORT_C TInt	GetAlarmData	(	TAlarmId	aAlarmId,
			HBufC8 *&	aSink
		)	const

Retrieves the data attached to the specified alarm.

This is data previously attached using AlarmDataAttachL().

capability: Note If the user does not have ReadUserData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	Unique identifier of the alarm under query.
aSink	On return, contains the data associated with the alarm, or NULL if the specified alarm does not have any associated data, or an error was returned.

Returns: KErrNone if successful, KErrNotFound if the specified alarm does not have any associated data, or a system-wide error.

GetAlarmDayOrTimed ( TAlarmId, TAlarmDayOrTimed & )

IMPORT_C TInt	GetAlarmDayOrTimed	(	TAlarmId	aAlarmId,
			TAlarmDayOrTimed &	aDayOrTimed
		)	const

Tests whether the specified alarm is for a timed or untimed event.

capability: None

Parameter	Description
aAlarmId	Unique identifier of the alarm under query.
aDayOrTimed	On return, whether an alarm is for a timed or untimed event.

Returns: KErrNone if successful, otherwise one of the system-wide errors.

GetAlarmDetails ( TAlarmId, TASShdAlarm & )

IMPORT_C TInt	GetAlarmDetails	(	TAlarmId	aAlarmId,
			TASShdAlarm &	aAlarm
		)	const

Retrieves information about a specified alarm.

capability: Note If the user does not have ReadUserData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	The unique identifier of the alarm under query.
aAlarm	On return, contains details of the alarm sought.

Returns: KErrNone if successful, KErrCouldNotConnect if the time zone server is not available, otherwise one of the other system-wide error codes.

GetAlarmIdListByStateL ( TAlarmState, RArray< TAlarmId > & )

IMPORT_C void	GetAlarmIdListByStateL	(	TAlarmState	aState,
			RArray< TAlarmId > &	aAlarmIds
		)	const

Retrieves a list of the unique identifiers of all alarms in a specified state.

capability: None

Parameter	Description
aState	Alarm state that you are interested in.
aAlarmIds	On return, contains the unique identifiers of the alarms in the specified state.

GetAlarmIdListForCategoryL ( TAlarmCategory, RArray< TAlarmId > & )

IMPORT_C void	GetAlarmIdListForCategoryL	(	TAlarmCategory	aCategory,
			RArray< TAlarmId > &	aAlarmIds
		)	const

Retrieves a list of all alarm identifiers for alarms within the server of a specified category.

capability: None

Parameter	Description
aCategory	Category of alarms to find.
aAlarmIds	On return, contains the list of alarms.

GetAlarmIdListL ( RArray< TAlarmId > & )

IMPORT_C void

GetAlarmIdListL

(

RArray< TAlarmId > &

aAlarmIds

)

const

Retrieves a list of the unique identifiers of all the alarms in the alarm server.

capability: None

Parameter	Description
aAlarmIds	On return, contains a list of unique identifiers.

GetAlarmOwner ( TAlarmId, TFullName & )

IMPORT_C TInt	GetAlarmOwner	(	TAlarmId	aAlarmId,
			TFullName &	aThreadName
		)	const

Deprecated8.0

Retrieves the full name of the thread that owns the specified alarm.

capability: None

Parameter	Description
aAlarmId	The unique identifier of the alarm under query.
aThreadName	On return, contains the name of the owning session.

Returns: KErrNone if successful, KErrNotFound if the alarm has no originating session ID or if the session is no longer connected, otherwise one of the system-wide errors.

GetAlarmPlayIntervalsL ( CArrayFix< TASCliSoundPlayDefinition > & )

IMPORT_C void

GetAlarmPlayIntervalsL

(

CArrayFix< TASCliSoundPlayDefinition > &

aIntervals

)

const

Retrieves the list of alarm intervals.

They are stored in ascending order of offset.

capability: None

Parameter	Description
aIntervals	On return, contains the list of alarm intervals.

GetAlarmSoundState ( TAlarmGlobalSoundState & )

IMPORT_C TInt

GetAlarmSoundState

(

TAlarmGlobalSoundState &

aState

)

const

Retrieves the alarm sound state. The alarm sound can be on or off.

capability: None

Parameter	Description
aState	On return, contains the alarm sound state.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

GetAlarmSoundsSilentUntil ( TTime & )

IMPORT_C TInt

GetAlarmSoundsSilentUntil

(

TTime &

aLocalTime

)

const

Retrieves the time at which all alarm sounds resume.

capability: None

Parameter	Description
aLocalTime	On return, contains the time, in local time, when sounds resume.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

GetAlarmStatus ( TAlarmId, TAlarmStatus & )

IMPORT_C TInt	GetAlarmStatus	(	TAlarmId	aAlarmId,
			TAlarmStatus &	aStatus
		)	const

Retrieves the status of the alarm.

capability: None

Parameter	Description
aAlarmId	The unique identifier of an alarm under query.
aStatus	On return, the alarm status.

Returns: KErrNone if successful, KErrNotFound if the alarm does not exist, otherwise one of the system-wide errors.

GetAvailableCategoryListL ( RArray< TAlarmCategory > & )

IMPORT_C void

GetAvailableCategoryListL

(

RArray< TAlarmCategory > &

aCategories

)

const

Retrieves a list of all alarm categories in use within the alarm server.

capability: None

Parameter	Description
aCategories	On return, contains the list of available categories.

GetNextDueAlarmId ( TAlarmId & )

IMPORT_C TInt

GetNextDueAlarmId

(

TAlarmId &

aAlarmId

)

const

Retrieves the unique identifier of the next alarm in the alarm server queue.

capability: None

Parameter	Description
aAlarmId	On return, contains the unique identifier of the next alarm due.

Returns: KErrNone if successful, KNullAlarmId if there are no alarms in the queue, otherwise another one of the system-wide error codes.

NotifyChange ( TRequestStatus &, TAlarmId & )

IMPORT_C void	NotifyChange	(	TRequestStatus &	aStatus,
			TAlarmId &	aAlarmId
		)

Enables client notification when alarm settings change, and when the next alarm time is calculated.

A panic occurs if notification is already active.

capability: None

NotifyChangeCancel ( )

IMPORT_C void

NotifyChangeCancel

(

)

const

Cancels any previous change notification request.

capability: None

panic: Panics with AlarmClientUtils::EAlarmClientPanicNotificationCancel if the notification fails to occur.

NumberOfAlarmsActiveInQueue ( )

IMPORT_C TInt

NumberOfAlarmsActiveInQueue

(

)

const

Returns the number of alarms that are currently active within the alarm queue. Active alarms are:

Alarms that have not yet notified.

Alarms that are in the queued or snoozed state, and are enabled.

capability: None

Returns: Number of active alarms, or an error code.

SetAlarmCharacteristics ( TAlarmId, TAlarmCharacteristicsFlags )

IMPORT_C TInt	SetAlarmCharacteristics	(	TAlarmId	aAlarmId,
			TAlarmCharacteristicsFlags	aCharacteristics
		)	const

Sets the characteristics of a specified alarm.

If the session-specific flag is removed, the outstanding notification is completed.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	Unique identifier of the alarm.
aCharacteristics	Alarm characteristics to apply.

Returns: KErrNone if successful, otherwise one of the system-wide errors.

SetAlarmDayOrTimed ( TAlarmId, TAlarmDayOrTimed )

IMPORT_C TInt	SetAlarmDayOrTimed	(	TAlarmId	aAlarmId,
			TAlarmDayOrTimed	aDayOrTimed
		)	const

Specifies whether an alarm belongs to a timed or untimed event.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	Unique identifier of the alarm.
aDayOrTimed	Whether an alarm is for a timed or untimed event.

Returns: KErrNone if successful, otherwise one of the system-wide errors.

SetAlarmPlayIntervalsL ( const CArrayFix< TASCliSoundPlayDefinition > & )

IMPORT_C void

SetAlarmPlayIntervalsL

(

const CArrayFix< TASCliSoundPlayDefinition > &

aIntervals

)

const

Sets the list of alarm intervals.

Alarm intervals consist of a duration and an offset.

capability: WriteDeviceData

leave: KErrGeneral If the array is inappropriate, for example, if intervals overlap or has no elements. Also, from v9.2 onwards, if the array has only one element and the Repeat Setting is set to RepeatLast.

leave: KErrArgument If no interval has an offset of zero.

leave: KErrNotSupported The Alarm Play Intervals cannot be set because Alarm Play Intervals is disabled by resource file. (from v9.2 onwards)

Parameter	Description
aIntervals	Contains one or more alarm intervals. There must be one interval in the array with an offset of zero.

SetAlarmSoundState ( TAlarmGlobalSoundState )

IMPORT_C TInt

SetAlarmSoundState

(

TAlarmGlobalSoundState

aState

)

const

Sets the alarm sound state to on or off.

capability: WriteDeviceData

Parameter	Description
aState	The alarm sound state.

Returns: KErrNone if successful, otherwise one of the system-wide errors.

SetAlarmSoundsSilentFor ( TTimeIntervalMinutes )

IMPORT_C TInt

SetAlarmSoundsSilentFor

(

TTimeIntervalMinutes

aTimeToRemainSilentFor

)

const

Disables alarm sounds for a specified interval.

Alarms still expire and clients are notified during this period, but no sound is played.

NOTE: If user or some application changes system time or UTC offset (for example by using User::SetUTCOffset(), User::SetHomeTime(), User::SetUTCTimeAndOffset() etc) the silent periond will be cancelled.

capability: WriteDeviceData

Parameter	Description
aTimeToRemainSilentFor	Time interval in minutes, during which no sound is to be played.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

SetAlarmSoundsSilentUntil ( const TTime & )

IMPORT_C TInt

SetAlarmSoundsSilentUntil

(

const TTime &

aLocalTime

)

const

Disables alarm sounds until a specified time.

Alarms still expire and clients are notified during this period, but no sound is played.

capability: WriteDeviceData

Parameter	Description
aLocalTime	Time, in local time, when alarm sounds are to be played once more.

Returns: KErrNone if successful, KErrArgument if the time is in the past, otherwise another one of the system-wide error codes.

SetAlarmStatus ( TAlarmId, TAlarmStatus )

IMPORT_C TInt	SetAlarmStatus	(	TAlarmId	aAlarmId,
			TAlarmStatus	aStatus
		)	const

Sets an alarm's status to either enabled or disabled.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarmId	Unique identifier of the alarm.
aStatus	Contains the status to be applied.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

SetAlarmStatusByCategory ( TAlarmCategory, TAlarmStatus )

IMPORT_C TInt	SetAlarmStatusByCategory	(	TAlarmCategory	aCategory,
			TAlarmStatus	aStatus
		)	const

Set the status of all alarms in the specified category.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aCategory	An alarm category.
aStatus	An alarm status.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

SetAlarmStatusForCalendarFile ( const TDesC &, TAlarmStatus )

IMPORT_C TInt	SetAlarmStatusForCalendarFile	(	const TDesC &	aFileName,
			TAlarmStatus	aStatus
		)	const

Sets the alarm status for calendar file

Parameter	Description
aFileName	Calendar file name
aStatus	Contains the status to be applied.

Returns: KErrNone if successful, otherwise one of the system-wide error codes.

SetClientData ( const TASShdAlarm & )

IMPORT_C TInt

SetClientData

(

const TASShdAlarm &

aAlarm

)

Sets if the alarm is a wakeup alarm

capability: None

The TASShdAlarm class contains a number of client-specific fields. These fields are for use by clients of the alarm server to hold any data associated with an alarm. Although this data is not used in any way by the alarm server itself, clients can ensure that the alarm server keeps its own copy of the specified alarm up to date with that of the client.

capability: Note If the user does not have WriteDeviceData capability then we need to check that the alarm belongs to the user SID (The SID is stored as part of the alarm)

Parameter	Description
aAlarm	The client-side alarm, whose corresponding server-side alarm is to be updated.

Returns: KErrNone if successful, otherwise one of the system-wide errors. Updates an alarm's client-specific data in the alarm server.KErrNone if successful, otherwise one of the system-wide error codes.

Version ( )

IMPORT_C TVersion

Version

(

)

const

Provides the version number of the alarm server.

capability: None

Returns: The version number.

__DbgFailAlloc ( TInt )

IMPORT_C void

__DbgFailAlloc

(

TInt

aCount

)

const

In debug builds, this will fail a memory allocation.

capability: None

Parameter	Description
aCount	Set this to the number of allocations to fail, or 0 to reset the failure tool.

__DbgPreventUserNotify ( TBool )

IMPORT_C void

__DbgPreventUserNotify

(

TBool

aShouldStop

)

const

In debug builds, this will prevent the Alarm Server from notifying the Alarm Alert Server about the expiry of an alarm.

capability: None

Parameter	Description
aShouldStop	ETrue: Alarm Alert Server is not notified on alarm expiry EFalse: Alarm Alert Server is notified on alarm expiry

__DbgSetEnvChgHandling ( TBool )

IMPORT_C TInt

__DbgSetEnvChgHandling

(

TBool

aFlag

)

const

In debug builds, this will switch handling of time/date changes by CASSrvEnvironmentChangeManager

capability: None

Parameter	Description
aFlag	ETrue to enable and EFalse to disable handling

__DbgShutDownServer ( )

IMPORT_C void

__DbgShutDownServer

(

)

const

In debug builds, this will cause the Alarm Server to terminate.

capability: None

__DbgSnoozeAlarm ( TAlarmId, const TTime & )

IMPORT_C TInt	__DbgSnoozeAlarm	(	TAlarmId	aAlarmId,
			const TTime &	aNewTime
		)	const

In debug builds, this will cause the specified alarm to be snoozed.

capability: None

Parameter	Description
aAlarmId	Unique identifier of the alarm.
aNewTime	Time to reawaken alarm (as UTC time).

Returns: Returns whether the alarm could be snoozed.

Parameter	Description
aStatus	The request status object that is to be signalled. On return, contains one of the TAlarmChangeEvent enumeration values. If an error occurs, the TRequestStatus object contains one of the standard system-wide error codes.
aAlarmId	An alarm identifier relating to the type of event that took place. If the type of event that occurred relates to a particular alarm, this object is populated with that alarm's identiifer. Otherwise it contains an undefined value.