System Agent Overview

Provides a central repository of information about the state, particularly relating to power and communications, of the Symbian OS phone. Applications can ask to be informed when certain conditions are true, and they can also retrieve the current state.

The System Agent uses the client/server architecture.

The API has two key concepts: system agent client interface, and system agent variable.

System Agent maintains a collection of events, each identified by UID. Each event has an associated state represented by a single TInt variable.

A client can synchronously retrieve the current state of variables. A client can also ask to be notified of any change in a state, on a change in a specific state, or if a set of conditions become true.

The system agent client interface is provided by RSystemAgent.

Each variable monitored by the system agent is identified by a UID. The states associated with a variable are encoded in a TInt. A core set of variables is defined by the System Agent. Further variables may be added.

System Agent events and associated state variables are never persisted. This means that on a cold boot all values are lost.