Overview

This document describes how to use the Alarm Server API of Symbian OS. It is intended for software engineers who wish to write applications on the Symbian OS platform that will take advantage of the system’s Alarm Server component.

The Alarm Server manages the alarms in the system. It provides the following functionality:

• add and delete alarms

• delete alarms by category

• retrieve category of alarms

• show the number of alarms by category

• notify the client when alarm settings change

• display the number of active alarms in the alarm queue

• set the sound state of the alarm

The client interface to the Alarm Server is provided by RASCliSession.

The Alarm Server API can be used by many clients wishing to set alarms, such as clock or calendar applications. The Alarm Server manages a queue of alarms and notifies the Alarm Alert Server when an alarm expires. The Alarm Alert Server is then responsible for displaying the alarm dialog.