/*
* Copyright (c) 2006-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:      callback interface for browsing session
*
*/






#ifndef M_UPNPAVBROWSINGSESSIONOBSERVER_H
#define M_UPNPAVBROWSINGSESSIONOBSERVER_H

// INCLUDES
#include "upnpavsessionobserverbase.h"

// FORWARD DECLARATIONS
class CUpnpDevice;
class CUpnpObject;

/**
* Defines the response interface for the browsing session operations of the
* UPnP AV Controller.
*
* @since Series 60 3.1
*/
class MUPnPAVBrowsingSessionObserver : public MUPnPAVSessionObserverBase
    {

    public:

        /**
         * Returns a browse result received from a Media Server.
         *         
         * @since Series 60 3.1
         * @param aBrowseResponse browse response xml document
         * @param aError system wide error code
         * @param aMatches number of returned items
         * @param aTotalCount total number of objects on container
         * @param aUpdateId update id number
         * @return None
         */
        virtual void BrowseResponse(
                        const TDesC8& aBrowseResponse,
                        TInt aError,
                        TInt aMatches,
                        TInt aTotalCount,
                        const TDesC8& aUpdateId
                        ) = 0;

        /**
         * Returns a search result received from a Media Server.
         *
         * @param aSearchResponse search response xml document
         * @param aError system wide error code
         * @param aMatches number of returned items
         * @param aTotalCount total number of resulted items
         * @param aUpdateId update id number
         * @return None
         */
        virtual void SearchResponse( 
                        const TDesC8& aSearchResponse,
                         TInt aError,
                         TInt aMatches,
                         TInt aTotalCount,
                         const TDesC8& aUpdateId
                         ) = 0;

        /**
         * Returns search capabilities of the requested Media Server.
         *
         * @since Series 60 3.1
         * @param status aStatus  information
         * @param aSearchCapabilities the search capabilities
         * @return None
         */
        virtual void SearchCapabilitiesResponse( 
                         TInt aError,
                         const TDesC8& aSearchCapabilities 
                         ) = 0;

        /**
         * Notifies that the create container operation is complete.
         *
         * @since Series 60 3.1
         * @param aError status information
         * @param aObjectId  object ID of the new container
         */
        virtual void CreateContainerResponse( TInt aError, 
            const TDesC8& aObjectId ) = 0;

        /**
         * Notifies that the requested UPnP Object deletion is complete.
         *
         * @since Series 60 3.1
         * @param aStatus status information
         * @return None
         */
        virtual void DeleteObjectResponse( TInt aError ) = 0;
        
        /**
         * Notifies that the Media Server we have a session with has
         * disappeared. Session is now unusable and must be closed. 
         *
         * @since Series 60 3.1
         * @param aReason reason code
         * @return None
         */        
        virtual void MediaServerDisappeared(
            TUPnPDeviceDisconnectedReason aReason ) = 0;            
       
    };

#endif // M_UPNPAVBROWSINGSESSIONOBSERVER_H

// End of File