ncdengine/inc/ncdsubscriptionmanager.h
changeset 0 ba25891c3a9e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ncdengine/inc/ncdsubscriptionmanager.h	Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,86 @@
+/*
+* 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