/*

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

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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: 

*      Declaration of class FavouritesSrv and CFavouritesSrv

*      

*

*/

#ifndef FAVOURITES_SRV_H

#define FAVOURITES_SRV_H

//  INCLUDES

#include <e32base.h>

// FORWARD DECLARATION

class CTimeout;

class CBackupObserver;

// CLASS DECLARATION

/**

* Static methods to launch the Favourites Engine Server.

*/

class FavouritesSrv

    {

    public:     // New methods

        /**

        * Start the FavouritesEngine Server thread / process.

        * @return Error code.

        */

        static TInt Start();

        /**

        * Run the FavouritesEngine Server (entry function).

        * @return Error code.

        */

        IMPORT_C static TInt Run();

    };

/**

* Favourites Engine Server.

*/

NONSHARABLE_CLASS(CFavouritesSrv) : public CPolicyServer

    {

    public:     // Constructor

        /**

        * Two-phased constructor. Leaves on failure.

        * @return The constructed server.

        */

        static CFavouritesSrv* NewL();

        /**

        * Destructor.

        */

        virtual ~CFavouritesSrv();

    public:     // New methods

        /**

        * A session is closed.

        */

        void SessionClosed();

        /**

        * Access received message.

        * @return Received message.

        */

        inline const RMessage2& ReceivedMessage() const;

        /**

        * Set received message.

        * @param aMessage Received message.

        */

        inline void ReceivedMessage( const RMessage2& aMessage );

        /**

        * Panic client.

        * @param aCode Panic code.

        */

        void PanicClient( TInt aCode );

    private:    // Constructors and destructor

        /**

        * Constructor.

        */

        CFavouritesSrv();

        /**

        * Second-phase constructor.

        */

        void ConstructL();

    private:    // From CServer2

        /**

        * Create new session.

        * @param aVersion Version.

        * @param aMessage Message (unused).

        * @return New session.

        */

        CSession2* NewSessionL

            ( const TVersion& aVersion, const RMessage2& aMessage ) const;

        /** 

        * Performs a custom security check.

        * @param	aMsg The message to check.

		* @param	aAction A reference to the action to take if the security

		*   check fails.

		* @param 	aMissing A reference to the list of security attributes missing

		*	from the checked process.

		* @return A value from TCustomResult.

		*/

        TCustomResult CustomSecurityCheckL(const RMessage2& aMsg, 

        	TInt& aAction, TSecurityInfo& aMissing);

    private:    // Data

        RMessage2           iReceivedMessage; ///< Received message.

        CTimeout*           iExitTimer;       ///< Exit timer. Owned.

        CBackupObserver*    iBackupObserver;

};

#include "FavouritesSrv.inl"

#endif

// End of File