![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
Applications that use this class will not work correctly on a version of EPOC earlier than ER5.
Not applicable
msvapi.h
This mixin class provides the interface for notification of events from a Message Server session. The types of event are given in the enumeration TMsvSessionEvent. Clients must provide an object that implements the interface, and set it to be notified through CMsvSession::OpenSyncL() or CMsvSession::OpenASyncL(). Additional observers can also be added and removed: see Session observers.
virtual void HandleSessionEvent(TMsvSessionEvent aEvent, TAny* aArg1, TAny* aArg2, TAny* aArg3)=0;
The function is called by a session to indicate an event has occurred. The type of event is indicated by the value of aEvent. The interpretation of the TAny arguments depends on this type.
For most event types, the action that is taken, for example, updating the display, is client-specific. All clients though should respond to EMsvCloseSession and EMsvServerTerminated events.
TMsvSessionEvent aEvent |
Indicates the event type. |
TAny* aArg1 |
Event type-specific argument value |
TAny* aArg2 |
Event type-specific argument value |
TAny* aArg3 |
Event type-specific argument value |
One or more entries have been created. aArg1 is a CMsvEntrySelection of the new entries. aArg2 is the TMsvId of the parent entry. |
|
One or more index entries have been changed. aArg1 is a CMsvEntrySelection of the index entries. |
|
One or more entries have been deleted. aArg1 is a CMsvEntrySelection containing the IDs of the deleted entries. aArg2 is the TMsvId of the parent entry. |
|
One or more entries have been moved. aArg1 is a CMsvEntrySelection containing the IDs of the moved entries. aArg2 is the TMsvId of the new parent. aArg3 is the TMsvId of the old parent entry. |
|
A new MTM has been installed. aArg2 points to a TUid for the new MTM. |
|
A MTM has been uninstalled. aArg2 points to a TUid of the removed MTM. |
|
A CMsvStore has been deleted. aArg1 points to a CMsvEntrySelection containing the ID of the entry concerned. aArg2 points to the ID of the parent of the entry. |
|
A CMsvStore has been committed. aArg1 points to a CMsvEntrySelection containing the ID of the entry concerned. aArg2 points to the ID of the parent of the entry. |
|
Something has happening in the server, but this client was unable to retrieve the information. aArg1 points to the error code. |
|
An entry has just created a store. |
|
The client should immediately close the session with the Message Server. |
|
Received after a client has used CMsvSession::OpenAsyncL() to create a session. The session can now be used. |
|
Received after a client has used CMsvSession::OpenAsyncL() to create a session. The server could not be started, and aArg1 points to the error code. |
|
The Message Server index had been corrupted and had to be rebuilt. All local entries are recovered, but all remote entries have been lost. |
|
The Message Server has been terminated. All clients must close their sessions immediately. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |