/*

* Copyright (c) 2004-2009 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:

* Name        : startupadaptation.h

* Part of     : System Startup / Starter

* Interface   : Domain, Startup Adaptation API

* This header file defines the Startup Adaptation API command

* interface used to issue commands towards adaptation.

* Version     : %version: ou1s60rt#6 %

* This material, including documentation and any related computer

* programs, is protected by copyright controlled by Nokia.  All

* rights are reserved.  Copying, including reproducing, storing,

* adapting or translating, any or all of this material requires the

* prior written consent of Nokia.  This material also contains

* confidential information which may not be disclosed to others

* without the prior written consent of Nokia.

* Template version: 4.0

* Nokia Core OS *

*

*/

#ifndef __STARTUPADAPTATION_H__

#define __STARTUPADAPTATION_H__

#include <e32base.h>

#include <ssm/startupadaptationcommands.h>

/*

* @publishedPartner

* @released

*/

class MStartupAdaptationObserver;

/*****************************************************

*       Series 60 Customer

*       Needs customer implementation

*****************************************************/

/**

*  An ECOM plug-in interface class to be implemented by startup adaptation.

*

*  @since S60 3.2

*/

class CStartupAdaptation : public CBase

    {

public:  // Constructors and destructor

    /**

    * Create new startup adaptation plug-in object.

    *

    * @since S60 3.2

    *

    * @param anObserver An observer object for receiving command responses

    * and adaptation events.

    */

    inline static CStartupAdaptation* NewL(

        MStartupAdaptationObserver& anObserver );

    /**

    * Destructor.

    *

    * @since S60 3.2

    */

    inline virtual ~CStartupAdaptation();

public: // New functions

    /**

    * Issue a command to startup adaptation.

    *

    * @since S60 3.2

    *

    * @param aCommandId A command identifier.

    * @param aData      Data associated with the command.

    */

    virtual void CommandL(

        const StartupAdaptation::TCommand aCommandId,

        TDesC8& aData ) = 0;

    /**

    * Cancel a command.

    *

    * @since S60 3.2

    *

    * @param aCommandId A command identifier.

    */

    virtual void CancelCommandL(

        const StartupAdaptation::TCommand aCommandId ) = 0;

    /**

    * Get plug-in implementation version. Major and minor version numbers

    * are relevant.

    *

    * @since S60 3.2

    *

    * @return The plug-in implementation version.

    */

    virtual TVersion Version() const = 0;

private:    // Data

    /**

    * Plug-in identifier. Used to inform ECom after the object has been

    * destroyed.

    */

    TUid iDtorIDKey;

    };

#include <ssm/startupadaptation.inl>

#endif // __STARTUPADAPTATION_H__