Class RSAVarChangeNotify

RSAVarChangeNotify

Support

Supported from 6.0

Description

The interface to the System Agent for notifying changes to a state variable.

Note that after construction, RSystemAgentBase::Connect() must be called before using any of the services provided by this class.

Derivation

RHandleBase Handle to an object RSAVarChangeNotify The interface to the System Agent for notifying changes to a state variable RSessionBase Client-side handle to a session with a server RSystemAgentBase Base class for client handles to the System Agent

Defined in RSAVarChangeNotify:
NotifySaVarChangeL(), RSAVarChangeNotify(), ReleaseVariable()

Inherited from RHandleBase:
Close(), Duplicate(), Handle(), SetHandle()

Inherited from RSessionBase:
Attach(), CreateSession(), EAutoAttach, EExplicitAttach, Send(), SendReceive(), SetRetry(), Share(), TAttachMode

Inherited from RSystemAgentBase:
Connect(), Version()

See also:

• RSystemAgentBase::Connect()

RSAVarChangeNotify();

Description

Constructs an uninitialised instance.

void NotifySaVarChangeL(const TUid aVariable, const TInt aState);

Description

Notifies a change in the specified state variable to the System Agent.

Parameters

const TUid aVariable The UID identifying the state variable to be changed. const TInt aState The new state of the variable.

TInt ReleaseVariable(TUid aVariable);

Description

Requests the System Agent to free the memory associated with the state variable identified by the specified UID.

Note that the request is synchronous and only returns when it is complete, successfully or otherwise.

Parameters

TUid aVariable The UID identifying the state variable.

Return value

TInt KErrNone, if successful; KErrInUse, if another client has an outstanding notification request on this state variable; KErrAccessDenied, if the state variable is one of the standard built-in types; otherwise, one of the system-wide error codes.