/*

* Copyright (c) 2007 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:  PSM server message.

*

*/

#ifndef PSMSRVMESSAGE_H

#define PSMSRVMESSAGE_H

#include <e32base.h>

#include "psmmodechangeobserver.h"

class CPsmManager;

/**

 *  PSM Message

 *

 *  Wraps the message for PSM servers internal message handling

 *

 *  @since S60 5.0

 */

class CPsmMessage : public CBase,

                    public MPsmModeChangeObserver

    {

    public:  // Constructors and destructor

        /**

         * Two-phased constructor for external message

         *

         * @return New CSensrvMessage instance

         */

        static CPsmMessage* NewL( CPsmManager& aPsmManager );

        /**

         * Two-phased constructor for external message

         *

         * @return New CSensrvMessage instance

         */

        static CPsmMessage* NewLC( CPsmManager& aPsmManager );

        /**

         * Destructor.

         */

        virtual ~CPsmMessage();

        /**

         * Initializes the message. Must be done before message is

         * used first time and before use after each complete.

         *

         * @param aMessage Client message to wrap

         */

        void Initialize( const RMessage2& aMessage );

        /**

         * Completes the message

         *

         * @param aReason Completion reason identifier. Usually error code.

         */

        void Complete( TInt aReason ) const;

        /**

         * Observes the mode change completion

         */

        void NotifyPsmModeChangeComplete( const TInt aError );

    private:

        /**

         * C++ constructor.

         */

        CPsmMessage( CPsmManager& aPsmManager );

        /**

         * By default Symbian 2nd phase constructor is private.

         */

        void ConstructL();

    private:    // Data

        /**

         * Wrapped message

         */

        RMessage2 iMessage;

        /**

         * Reference to PSM manager

         */

        CPsmManager& iPsmManager;

    };

#endif // PSMSRVMESSAGE_H