/*
* Copyright (c) 2002-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:  Declares the MPCPObserver interface class
*
*/


#ifndef MPCPOBSERVER_H
#define MPCPOBSERVER_H

#include <e32def.h>
#include <e32std.h>

class CUpnpAction;
class CUpnpService;
class CUpnpDevice;
class CUpnpHttpMessage;

/**
*  @brief A virtual MPCPObserver class.
*
*  @since Series60 3.1
*/
class MPCPObserver
    {
    public: // New interface functions

        /**
    	* CreateJobResponse callback function
        * @since Series60 3.1
        * @param aAction the action
        * @param aErrorCode System wide error code
        */
        virtual void CreateJobResponse( CUpnpAction* aAction, TInt aErrorCode ) = 0;

        /**
    	* CancelJobResponse callback function
        * @since Series60 3.1
        * @param aAction the action
        * @param aErrorCode System wide error code
        */
        virtual void CancelJobResponse( CUpnpAction* aAction, TInt aErrorCode ) = 0;

        /**
    	* GetPrinterAttributesResponse callback function
        * @since Series60 3.1
        * @param aAction the action
        * @param aErrorCode System wide error code
        */
        virtual void GetPrinterAttributesResponse( CUpnpAction* aAction, TInt aErrorCode ) = 0;

        /**
    	* GetJobAttributesResponse callback function
        * @since Series60 3.1
        * @param aAction the action
        * @param aErrorCode System wide error code
        */
        virtual void GetJobAttributesResponse( CUpnpAction* aAction, TInt aErrorCode ) = 0;

        /**
    	* GetMarginsResponse callback function
        * @since Series60 3.1
        * @param aAction the action
        * @param aErrorCode System wide error code
        */
        virtual void GetMarginsResponse( CUpnpAction* aAction, TInt aErrorCode ) = 0;

        /**
    	* GetMediaListResponse callback function
        * @since Series60 3.1
        * @param aAction the action
        * @param aErrorCode System wide error code
        */
        virtual void GetMediaListResponse( CUpnpAction* aAction, TInt aErrorCode ) = 0;


        /**
    	* StateUpdatedResponse callback function
        * @since Series60 3.1
		* @param	TDesC8& New printer state
		* @param	TDesC8& Reason for the printer state		
		* @param	TDesC8& List of job ids pending at the printer queue		
		* @param	TDesC8& The end state of last printed job. Format: 
		*					<id>,<name>,<originator>,<completed sheets>,<state>
		* @param	TDesC8& Number of the printed sheets
		* @param	TDesC8& The abort state of last aborted job. Format: 
		*					<id>,<name>,<originator>,<completed sheets>,aborted,<reason>
		* @param	TDesC8& Number of the sheets completedly received in printer
        */
        virtual void StateUpdatedResponse( const TDesC8& aPrinterState, 
                                           const TDesC8& aPrinterStateReasons, 
                                           const TDesC8& aJobIdList,
	                                       const TDesC8& aJobEndState, 
                                           const TDesC8& aJobMediaSheetsCompleted, 
                                           const TDesC8& aJobAbortState,
                                           const TDesC8& aContentCompleteList ) = 0;

        /**
    	* DeviceDiscoveredL callback function
        * @since Series60 3.1
        * @param aDevice the device discovered
        */
        virtual void DeviceDiscoveredL( CUpnpDevice* aDevice ) = 0;

        /**
    	* DeviceDisappeared callback function
        * @since Series60 3.1
        * @param aDevice the device disappeared
        */
        virtual void DeviceDisappeared( CUpnpDevice* aDevice ) = 0;

		/*
		* @function		PrinterStateUpdated
		* @description	Returns the state of the job after printer state updated 
		* @param		TDesC8& New printer state
		*/
		virtual void PrinterStateUpdated( const TDesC8& aEvent ) = 0;
		
		/*
		* @function		PrinterStateReasonsUpdated
		* @description	Returns the state of the job after printer state reason updated 
		* @param		TDesC8& Reason for the printer state		
		*/
		virtual void PrinterStateReasonsUpdated( const TDesC8& aEvent ) = 0;
		
		/*
		* @function		JobIdListUpdated
		* @description	Returns the state of the job after job ID list updated 
		* @param		TDesC8& List of job ids pending at the printer queue		
		*/
		virtual void JobIdListUpdated( const TDesC8& aEvent ) = 0;

		/*
		* @function		JobEndStateUpdatedL
		* @description	Returns the state of the job after job end state updated 
		* @param		TDesC8& The end state of last printed job. Format: 
		*						<id>,<name>,<originator>,<completed sheets>,<state>
		*/
		virtual void JobEndStateUpdated( const TDesC8& aEvent ) = 0;

		/*
		* @function		JobMediaSheetsCompletedUpdated
		* @description	Returns the state of the job after media sheets completed list updated 
		* @param		TDesC8& Number of the printed sheets
		*/
		virtual void JobMediaSheetsCompletedUpdated( const TDesC8& aEvent ) = 0;

		/*
		* @function		JobAbortStateUpdatedL
		* @description	Returns the state of the job after job abort state updated 
		* @param		TDesC8& The abort state of last aborted job. Format: 
		*						<id>,<name>,<originator>,<completed sheets>,aborted,<reason>
		*/
		virtual void JobAbortStateUpdated( const TDesC8& aEvent ) = 0;

		/*
		* @function		ContentCompleteListUpdated
		* @description	Returns the state of the job after content completed list updated 
		* @param		TDesC8& Number of the sheets completedly received in printer
		*/
		virtual void ContentCompleteListUpdated( const TDesC8& aEvent ) = 0;

    };

#endif // MPCPOBSERVER_H

// End Of File