/*
* Copyright (c) 2005-2006 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:    header file for MIptvServiceManagementClientObserver class*
*/



#ifndef __MIPTVSERVICEMANAGEMENTCLIENTOBSERVER_H__
#define __MIPTVSERVICEMANAGEMENTCLIENTOBSERVER_H__

#include "CIptvNetworkSelection.h"
#include "CIptvService.h"

class CDesC8ArraySeg;
class CIptvSmEvent;

// CLASS DECLARATION

/**
* MIptvServiceManagementClientObserver
* class specifies the interface for CIptvServiceManagementClient callback functions.
* Client must inherit this and implement the virtual functions.
*/
class MIptvServiceManagementClientObserver
    {
    
    public: // Enumerations
    
        /**
        * TRespStatus.
        * Response statuses for requests.
        */
        enum TRespStatus
            {
            ESucceeded,
            EServiceNotFound,
            EGeneralError,
            ECancelled,
            EEmpty            
            };

    public:

        /**
        * AddServiceResp.
        * Callback function for AddServiceReq operation.
        * @param aRespStatus
        */
        virtual void AddServiceResp(TRespStatus aRespStatus) = 0;

        /**
        * UpdateServiceResp.
        * Callback function for UpdateServiceReq.
        * @param aRespStatus
        */
        virtual void UpdateServiceResp(TRespStatus aRespStatus) = 0;


        /**
        * DeleteServiceResp.
        * Callback function for DeleteServiceReq operation.
        * @param aRespStatus
        */        
        virtual void DeleteServiceResp(TRespStatus aRespStatus) = 0;

        /**
        * GetServicesResp.
        * Callback function for GetServicesReq() methods.
        * @param aRespStatus ESucceeded is returned even if no matching
        *        services were found. In that case the aServicesArray contains
        *        empty array. If aRespStatus != ESucceeded, aServicesArray
        *        pointer is NULL.
        * @param aServicesArray contains array of pointers to descriptors.
        *        aServicesArray ownership moves from server to client, ie client
        *        is responsible for freeing the array.
        *        Array elements are binary descriptors built with CIptvService::GetL() method.
        *        CIptvService::SetL() method can be used to init CIptvService class with
        *        array element data.
        *        In case of error, aServicesArray is NULL.
        */
        virtual void GetServicesResp(TRespStatus aRespStatus, 
                                     CDesC8ArraySeg* aServicesArray) = 0;

        /**
        * GetUsedIapResp.
        * Callback function for GetUsedIapReq() method.
        * @param aIapId IAP ID which client should use when connecting to service.
        * @param aIapName
        * @param aConnectionPermission
        * @param aWlanWhenGPRS
        * @param aRespStatus If != ESucceeded, aIapId, aIapName and aConnectionPermission
        *                    do not contain valid data.
        */
        virtual void GetUsedIapResp(TUint32 aIapId,
                                    const TDesC& aIapName,
                                    CIptvNetworkSelection::TConnectionPermission aConnectionPermission,
                                    TBool   aWlanWhenGPRS,
                                    CIptvNetworkSelection::TRespStatus aRespStatus
                                    ) = 0;

        /**
        * ServerShutdownResp.
        * Callback function for ServerShutdownReq operation.
        * @param aRespStatus
        */
        virtual void ServerShutdownResp(TRespStatus aRespStatus) = 0;

        /**
        * Service Manager generated events handle function.
        * @param aEvent
        */        
        virtual void HandleSmEvent(CIptvSmEvent& aEvent) = 0;

    };

#endif // __MIPTVSERVICEMANAGEMENTCLIENTOBSERVER_H__