/*
* Copyright (c) 2006 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:   Definition of MNcdSubscriptionManager interface
*
*/


#ifndef M_NCDSUBSCRIPTIONMANAGER_H
#define M_NCDSUBSCRIPTIONMANAGER_H

#include "catalogsbase.h"
#include "ncdinterfaceids.h"
#include "catalogsarray.h"

class MNcdSubscription;
class MNcdSubscriptionOperation;
class MNcdSubscriptionOperationObserver;

/**
 *  Subscription manager interface.
 *
 *  This interface describes a subscription manager. Subscription manager
 *  provides methods for subscription management.
 *
 *  
 */
class MNcdSubscriptionManager : public virtual MCatalogsBase
    {
    
public:

    /**
     * Unique identifier for the interface, required for all MCatalogsBase interfaces.
     *
     * 
     */
    enum { KInterfaceUid = ENcdSubscriptionManagerUid };


    /**
     * Get all subscriptions.
     *
     * @note This function should be called to get current and valid list of
     *       subscriptions after changes to subscriptions.
     *
     * 
     * @return Array of made subscriptions. Counted, Release() must be called
     *  for each object after use, e.g. with a call to
     *  RCatalogsArray::ResetAndDestroy()
     */
    virtual RCatalogsArray< MNcdSubscription > SubscriptionsL() const = 0;

    /**
     * Refresh subscriptions from service providers. 
     *
     * 
     * @param aObserver Operation observer interface.
     * @return Subscription operation object. Counted, Release() must be called after use.
     * @exception Leave System wide error code.
     */
    virtual MNcdSubscriptionOperation* RefreshSubscriptionsL( 
        MNcdSubscriptionOperationObserver& aObserver ) = 0;

protected: // Destruction

    /**
     * Destructor.
     *
     * @see MCatalogsBase::~MCatalogsBase
     */
    virtual ~MNcdSubscriptionManager() {}

    };

#endif // M_NCDSUBSCRIPTIONMANAGER_H