/*

* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  Sub-session class of the Storage Server

*

*/

#ifndef __CPENGSTORAGESUBSESSION_H__

#define __CPENGSTORAGESUBSESSION_H__

//  INCLUDES

#include <e32base.h>

#include <badesca.h>

#include "TPEngStorageServerMessages.h"

// FORWARD DECLARATIONS

class MPEngStorageServer;

class RPEngMessage;

class CPEngStorageFolder;

class CPEngDataEntry;

/**

 *  Subsession of the Storage Server

 *  @since 3.0

 */

class CPEngStorageSubSession : public CObject

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CPEngStorageSubSession* NewL( MPEngStorageServer& aServer,

                                             const RPEngMessage& aMessage,

                                             TInt32 aSessionId );

        /**

        * Two-phased constructor.

        */

        static CPEngStorageSubSession* NewLC( MPEngStorageServer& aServer,

                                              const RPEngMessage& aMessage,

                                              TInt32 aSessionId );

        /**

        * Destructor.

        */

        virtual ~CPEngStorageSubSession();

    public: // Function for handling of the clients requests

        /**

          * Dispatch message from the Sub Session

          *

          *	@since 3.0

          *	@param aMessage is received message.

          *	@return ETrue if message should be completed

          */

        TBool DispatchMessageL( const RPEngMessage& aMessage,

                                TInt aRequest );

        /**

          * Set Sub-session handle ID for the Session

          *

          *	@since 3.0

          *	@param aHandle Sub-session handle

          */

        void SetSubSesionHandle( TInt aHandle );

    private:  // Functions from base classes

        /*

         *	Client is panicked using this method.

         *

         *	@since 3.0

         *	@param	aMessage clients message

         *	@param	aPanic panic reason

         */

        void PanicClient( const RPEngMessage& aMessage, const TInt aPanic ) const;

        /**

         *	Resume Notification of the SIDs

         *

         *	@since 3.0

         *	@param aCount count do decrease Notification lock counter

         */

        void ResumeSIDsNotification( TInt aCount );

    private:

        /**

        * C++ constructor.

        */

        CPEngStorageSubSession( TInt32 aSessionId );

        /**

        * Symbian 2nd phase constructor

        */

        void ConstructL( MPEngStorageServer& aServer, const RPEngMessage& aMessage );

    private:    // Data

        ///	OWN: Buffer of changed SIDs which notification was postponed

        RPointerArray<CPEngDataEntry>		iBufferedNotif;

        /// OWN: Counter of the buffering activation

        TInt								iBufferingActiveCounter;

        /// REF: Storage Cage

        CPEngStorageFolder*					iStorageFolder;

        /// OWN: Sub Session Handle

        TInt								iHandle;

        /// OWN: Session Id

        const TInt32                        iSessionId;

    };

#endif      // __CPENGSTORAGESUBSESSION_H__

// End of File