cmsvhandler.h

Symbian 手机发送彩信程序 mmssend

/*  Copyright (c) 2004, Nokia. All rights reserved */


#ifndef __CMSVHANDLER_H__
#define __CMSVHANDLER_H__

// INCLUDES
#include <e32base.h>


// FORWARD DECLARATIONS
class CClientMtmRegistry;
class MMsvObserver;

// CLASS DECLARATION
	/**
	* Pure virtual Base class for handling asynchronous 
    * message server requests.
	*/
class CMsvHandler : public CActive, public MMsvSessionObserver
    {
    public:

        /**
        * ~CExMsvHandler
        * Destroy the object and release all memory objects
        */
        virtual ~CMsvHandler();

        /**
        * IsIdle
        * Determine whether we are initialised 
        * (the CMsvSession can be used)
        * @result true if we have initialised 
        */
        virtual TBool IsIdle();

    protected:
        /**
        * From CActive, DoCancel
        * Cancel any outstanding operation
        */
        void DoCancel();

        /**
        * ConstructL
        * Perform the second phase construction of a CMsvHandler object
        */
        void ConstructL();

        /**
        * CExMsvHandler
        * Perform the first phase of two phase construction
        * @param aObserver the object to be used to handle status/error reports
        */
        CMsvHandler( MMsvObserver& aObserver );

        /**
        * CompleteConstructL
        * Creates client MTM registry when session is ready for use. 
        * This completes model construction and is called after 'server
        * ready' event is received after async opening of CMsvSession.
        */
        virtual void CompleteConstructL();

        /**
        * SetMtmEntryL
        * Set the Mtm's current context(entry). 
        * Creates an Mtm if we haven't already
        * @param aEntryId the entry to set
        */
        virtual void SetMtmEntryL( TMsvId aEntryId );


    protected: //Member variables
        /**
        * iOperation the currently pending message server operation
        * Owned by the send and the receive handler
        */
        CMsvOperation*      iOperation;

        /**
        * iSession the client session on the message server
        * Owned by the send and the receive handler
        */
        CMsvSession*        iSession;

        /**
        * iMtm The message type module
        * Owned by the send and the receive handler
        */
        CBaseMtm*           iMtm;

        /**
        * iMtmRegistry The Mtm client registry for creating new mtms
        * Owned by the send and the receive handler
        */
        CClientMtmRegistry* iMtmRegistry;

        /**
        * iObserver The Observer to report status/error information
        * Owned by the send and the receive handler
        */
        MMsvObserver&       iObserver;

    };

#endif // __CMSVHANDLER_H__