/*
* Copyright (c) 2003 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:  This file contains the header file of the CCbsEtelMessaging class.
*    
*                CCbsEtelMessaging is a wrapper to RMobileBroadcastMessaging used 
*                in network builds.
*
*/



#ifndef CCBSETELMESSAGING_H
#define CCBSETELMESSAGING_H

// INCLUDES
		/*****************************************************
		*	Series 60 Customer / ETel
		*	Series 60  ETel API
		*****************************************************/
#include <etelmm.h>            

#include <e32base.h>
#include "MCbsEtelMessaging.h"

//  CLASS DECLARATION 

/**
*   CCbsEtelMessaging acts as a wrapper to RMobileBroadcastMessaging instance.
*
*/
class CCbsEtelMessaging : public CBase, public MCbsEtelMessaging
    {
    public:

        /**
        *   Creates and returns a new instance of CCbsEtelMessaging.
        *
        *   @return Instance of CCbsEtelMessaging.
        */
        static CCbsEtelMessaging* NewL();

        /**
        *   Destructor.
        */
        virtual ~CCbsEtelMessaging();

    public:     // MCbsEtelMessaging

        /**
        *   Opens an emulated ETel messaging session.
        *
        *   @param  aPhone RMobilePhone-session
        */
        TInt Open( RMobilePhone& aPhone );

        /**
        *   Closes ETel messaging session.
        */
        void Close();

        /**
        *   Requests forwarding of the next received CB message.
        *
        *   @param  aReqStatus          Client request status
        *   @param  aMsgData            CBS message data descriptor
		*	@param	aMsgAttributes		CBS message attributes
        */
        void ReceiveMessage( TRequestStatus& aReqStatus, TDes8& aMsgData, 
            TDes8& aMsgAttributes );
        
        /**
        *   Cancels an outstanding ReceiveMessage() request.
        */
        void ReceiveMessageCancel();

        /**
        *   Sets CBS receive mode (filter setting).
        *
        *   @param  aReqStatus          Returns: status of async operation
        *	@param	aSetting			The new filter setting to be set to ETel
        */
        void SetFilterSetting( TRequestStatus& aReqStatus, 
            RMobileBroadcastMessaging::TMobilePhoneBroadcastFilter aSetting ) const;

        /**
        *   Cancels an outstanding SetFilterSetting() request.
        *
        */
        void SetFilterSettingCancel();

        /**
        *   Retrieves the current CBS receive mode (filter setting).
        *
        *   @param  aSetting			The setting to beffiled by ETel
        *   @return                     Result code
        */
        TInt GetFilterSetting( 
			RMobileBroadcastMessaging::TMobilePhoneBroadcastFilter& aSetting );        

    private: // Private methods

        /**
        *   Constructor.
        */
        CCbsEtelMessaging();

        /**
        *   Finalizes the construction.
        */
        void ConstructL();

    private: // Data

        // ETel messaging session to which calls to this class are forwarded.
        RMobileBroadcastMessaging iMessaging;
    };

#endif      //  CCBSETELMESSAGING_H
            
// End of File