examples/ForumNokia/SMSExample/Engine/inc/SMSExampleMtmsEngine.h

/*
 * Copyright © 2008 Nokia Corporation.
 */

#ifndef SMS_EXAMPLE_ENGINE
#define SMS_EXAMPLE_ENGINE

// INCLUDES 
#include <e32base.h> // CBase
#include <msvapi.h>  // MMsvSessionObserver
#include <badesca.h> // CDesCArrayFlat

// FORWARD DECLARATIONS
class CClientMtmRegistry;
class CSmsClientMtm;
class MSMSExampleMtmsEngineObserver;

// CLASS DECLARATION

class CSMSExampleMtmsEngine : public CActive, public MMsvSessionObserver
    {
    public:
       
        static CSMSExampleMtmsEngine* NewL(MSMSExampleMtmsEngineObserver& 
                                           aObserver);
        
        ~CSMSExampleMtmsEngine();

    public:

        void MoveToFolderL( TMsvId aMessageId,  TMsvId aFolder );

        void DeleteMessageL( TMsvId aMessageId );

        void CopyMessageL( TMsvId aMessageId, TMsvId aFolder );

        void GetMessageAddressL( TMsvId aMessageId, TDes& aAddress );

        TBool GetMessageL( TMsvId aMessageId, TDes& aMessage );

        TBool GetMessageIndexBodyTextL( TMsvId aMessageId, TDes& aMessage );

        void GetFolderSMSMessageInformationL( TMsvId aFolderID, 
                                              CDesCArrayFlat*& aAddresses, 
                                              CDesCArrayFlat*& aMessages );

        RArray<TMsvId>* GetMessageIds();

    private:
        CSMSExampleMtmsEngine(MSMSExampleMtmsEngineObserver& aObserver);

        void ConstructL();

        void CreateMtmClientL();

    private: // from CActive
        virtual void DoCancel();
        virtual void RunL();


    private: // from MMsvSessionObserver
        void HandleSessionEventL(TMsvSessionEvent aEvent, TAny* aArg1, 
                                 TAny* aArg2, TAny* aArg3);

    private:

        // SMS client MTM interface
        CSmsClientMtm*      iSmsMtm;

        // Observer of this engine.
        MSMSExampleMtmsEngineObserver& iObserver;

        // Controls asynchronous commands in the messaging system
        // Get progress information about the sending.
        CMsvOperation*      iMsvOper;

        // Encapsulates an array of entry IDs.
        CMsvEntrySelection* iEntrySelection;

        // Represents a session to the messaging server
        CMsvSession*        iSession;   

        // This registry holds details of the all the Client-side 
        // MTMs currently available on the system. 
        CClientMtmRegistry* iClientMtmReg;
       
        // Array of ids
        RArray<TMsvId>*     iIdArray;
       
        // Id of an SMS message
        TMsvId              iSmsId;
    };

class MSMSExampleMtmsEngineObserver
    {
    public:
        virtual void HandleMessageSentL(TInt aError) = 0;
    };


#endif  // SMS_EXAMPLE_ENGINE

---