Cancels an active notifier.

This is called as a result of a client-side call to RNotifier::CancelNotifier() .

An implementation should free any relevant resources, and complete any outstanding messages, if relevant.

RNotifier::CancelNotifier

Gets the notifier parameters.

This is the same information as returned by RegisterL() , although the returned values may be varied at run-time.

Performs any initialisation that this notifier may require.

The function is called when the notifier is first loaded, i.e. when the plug-in DLL is loaded. It is called only once.

As a minimum, the implementation should return a TNotifierInfo instance describing the notifier parameters. A good implementation would be to set up a TNotifierInfo as a data member, and then to return it. This is because the same information is returned by Info() .

The function is safe to leave from, so it is possible, although rarely necessary, to allocate objects as you would normally do in a ConstructL() function as part of two-phase construction.

MNotifierBase2::Info

Frees all resources owned by this notifier.

This function is called by the notifier framework when all resources allocated by notifiers should be freed. As a minimum, the implementation should delete this object (i.e. delete this;).

Note that it is important to implement this function correctly to avoid memory leaks.

Sets the notifier manager.

Starts the notifier.

This is called as a result of a client-side call to RNotifier::StartNotifier() , which the client uses to start a notifier from which it does not expect a response.

The function is synchronous, but it should be implemented so that it completes as soon as possible, allowing the notifier framework to enforce its priority mechanism.

It is not possible to wait for a notifier to complete before returning from this function unless the notifier is likely to finish implementing its functionality immediately.

RNotifier::StartNotifier

Starts the notifier.

This is called as a result of a client-side call to the asynchronous function RNotifier::StartNotifierAndGetResponse() . This means that the client is waiting, asynchronously, for the notifier to tell the client that it has finished its work.

It is important to return from this function as soon as possible,

The implementation of a derived class must make sure that Complete() is called on the RMessage2 object when the notifier is deactivated.

This function may be called multiple times if more than one client starts the notifier.

RNotifier::StartNotifierAndGetResponse

Updates a currently active notifier with new data.

This is called as a result of a client-side call to RNotifier::UpdateNotifier() .

RNotifier::UpdateNotifier

Defines a set of notifier priorities. The use and application of these values is implementation dependent. ENotifierPriorityAbsolute defines the highest priority value; subsequent enum values define decreasing priority values.