The Alarm Server sends notifications to applications when alarm
settings change; this includes indications when an alarm goes off.
A client-side API for the alarm server is RASCliSession. It is a standard asynchronous service provider, and the client
application should implement an active object to receive events.
To be able to use the Alarm Server services, client applications must first be connected to the server.
User::LeaveIfError( iAlarmServer.Connect() );
To receive events, the NotifyChange( TRequestStatus
&aStatus, TAlarmId &aAlarmId ) function is called
and the active object is set active.
iAlarmServer.NotifyChange( iStatus, iAlarmId ); SetActive();
Notifications are cancelled by calling the NotifyOnChangeCancel() function.
iAlarmServer.NotifyChangeCancel();
When alarm settings change, the RunL() function
of the active object is called. Alarms in the alarm server database
can be retrieved using the GetAlarmIdListL() function,
which fills an array of alarm IDs.
void GetAlarmIdListL( RArray< TAlarmId > &aAlarmIds )
When using RArray, remember to call Close() or Reset() on it when it
is not needed anymore. The RASCliSession::GetAlarmDetails() function returns the TASShdAlarm structure
for a specific alarm, which is identified by the alarm ID.
TInt GetAlarmDetails( TAlarmId aAlarmId, TASShdAlarm &aAlarm )
The TASShdAlarm structure contains information
about an alarm, and information is accessed through simple inline
functions. See the ASShdAlarm.h header file for
further information.